SeeGen AI API

Überblick

SeeGen AI ist eine einheitliche Generierungs-API: ein konsistenter Satz von Endpunkten, um mehrere führende KI-Video- und Bildmodelle auszuführen. Wählen Sie ein Modell über den Parameter model — Authentifizierung, Task-Einreichung, Status-Abfrage und Webhooks funktionieren bei allen gleich.

Aktuell verfügbare Modelle:

• Video — Seedance 2.0 Pro (sd2), Seedance 2.0 Fast (sd2-fast), Seedance 2.0 Mini (sd2-mini), Seedance 2.5 (sd2.5), HappyHorse 1.1 (happyhorse)
• Bild — GPT Image 2 (gpt-image-2), Nano Banana 2 (nano-banana-2), Nano Banana Pro (nano-banana-pro), Seedream 5.0 Lite (seedream-v5.0-lite), Seedream 5.0 Pro (seedream-v5.0-pro)

Warum SeeGen AI?

Weitere Gründe für SeeGen AI:

• Mehr als nur Seedance 2.0: HappyHorse 1.1, Nano Banana, ChatGPT Image und mehr.
• Kein Abonnement erforderlich — Pay-as-you-go
• Schneller Zugriff auf die neuesten Modelle
• Kundensupport rund um die Uhr (24/7)
• Unterstützung bei offiziellen modellbezogenen Anfragen
• Konsolenzugriff für Entwickler
• Offen für Unternehmen und Privatnutzer

Preise

🎉 Zeitlich begrenztes Angebot: 33% Rabatt auf die gesamte Bildgenerierung — alle Bildpreise unten sind bereits reduziert.

Prüfen Sie Ihr Guthaben: GET /api/v1/account/credits

Authentifizierung

Alle API-Anfragen erfordern ein Bearer-Token im Authorization-Header. Sie können API-Schlüssel in Ihren Kontoeinstellungen erstellen und verwalten.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://seegen.ai/api/v1/account/credits

Schnellstart

Generieren Sie ein Video in zwei Schritten: Erstellen Sie einen Task und fragen Sie dann das Ergebnis ab.

# 1. Create a text-to-video task
TASK_ID=$(curl -s -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "prompt": "A golden retriever running on the beach at sunset",
      "duration": "5s",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask | jq -r '.taskId')

echo "Task created: $TASK_ID"

# 2. Poll for result
while true; do
  RESULT=$(curl -s -H "Authorization: Bearer $API_KEY" \
    "https://seegen.ai/api/v1/jobs/queryTask?taskId=$TASK_ID")
  STATUS=$(echo $RESULT | jq -r '.status')
  echo "Status: $STATUS"
  if [ "$STATUS" = "COMPLETED" ] || [ "$STATUS" = "FAILED" ]; then
    echo $RESULT | jq .
    break
  fi
  sleep 5
done

Endpunkte

Modell auswählen (Video)

Zwei Modellfamilien generieren Video. Wählen Sie nach Modus + Preis; kombinieren Sie dies mit dem Abschnitt Preise, um die Kosten zu schätzen.

T2V = Text zu Video · I2V = Bild zu Video (erstes Bild) · First–Last = erstes + letztes Keyframe · Multi-Ref = gemischte Bild- / Video- / Audio-Referenzen · R2V = 1–9 Referenzbilder mit Charaktermarkierungen

Seedance 2.0 / 2.0 Fast / 2.0 Mini / Seedance 2.5

Text zu Video

Generieren Sie ein Video aus einem Text-Prompt. Keine Bilder erforderlich.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "prompt": "A futuristic city with flying cars at night, neon lights reflecting on wet streets",
      "duration": "5s",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Video

Animieren Sie ein statisches Bild zu einem Video. Geben Sie eine Bild-URL als Startbild an.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": ["https://example.com/photo.jpg"],  // or "asset://asset-20260326-abc123"
      "prompt": "The woman slowly turns her head and smiles",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Erstes & letztes Bild

Definieren Sie das Start- und Endbild, und das Modell generiert den Übergang dazwischen. Verwendet videoInputMode: "keyframe".

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": [
        "https://example.com/first-frame.jpg",
        "https://example.com/last-frame.jpg"
      ],
      "prompt": "Smooth camera transition from day to night",
      "duration": "5s",
      "videoInputMode": "keyframe"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Multi-Referenz

Verwenden Sie mehrere Referenzbilder, -videos und -audiodateien, um die Generierung zu steuern. Verwendet videoInputMode: "reference". Bei sd2.5 ist dies der Standard-Reference-Subtask; um ein bestehendes Video zu bearbeiten oder fortzusetzen, siehe Video bearbeiten & erweitern weiter unten.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      "videoUrls": ["asset://asset-motion-video"],
      "audioUrls": ["https://example.com/audio.mp3"],
      "prompt": "Character walks through a garden",
      "duration": "5s",
      "videoInputMode": "reference",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Video bearbeiten & erweitern

sd2.5 unterteilt die referenzbasierte Generierung in drei Subtasks. Lassen Sie mode für gewöhnliche Reference-Generierung weg, setzen Sie mode: "edit", um ein bestehendes Video zu bearbeiten, oder mode: "extend", um es fortzusetzen. Beide erfordern mindestens ein Video in videoUrls und geben stets das Seitenverhältnis des Quellvideos aus.

Platzieren Sie das Video, das Sie bearbeiten möchten, zuerst in videoUrls und verweisen Sie in Ihrem Prompt darauf als "Video 1". edit erzwingt, dass die Ausgabelänge diesem ersten (Quell-)Video entspricht, das 4–30s lang sein muss, sodass jeder von Ihnen gesendete duration-Wert ignoriert wird; die Abrechnung verwendet die Dauer des Quellvideos als Ausgabedauer, zuzüglich aller Referenzvideos als Eingabe. extend akzeptiert 1–3 in Reihenfolge zusammengefügte Clips, und der von Ihnen angeforderte duration-Wert ist die Ausgabelänge dieser Generierung (unabhängig von der Quelllänge) — Abrechnung wie bei gewöhnlicher Reference-Generierung.

Die Modelle der 2.0-Familie (sd2 / sd2-fast / sd2-mini) akzeptieren ebenfalls mode: "edit" und mode: "extend": Sie leiten die Operation aus Ihrem Prompt ab (beschreiben Sie die Bearbeitung oder Fortsetzung explizit), das Seitenverhältnis folgt dem Quellvideo, und duration bleibt bei gewöhnlicher Abrechnung unter Ihrer Kontrolle.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2.5",
    "inputs": {
      "mode": "edit",
      "videoUrls": ["asset://asset-source-video"],
      "urls": ["https://example.com/annotation-at-1.2s.png"],
      "source_frame_timestamps_ms": [1200],
      "prompt": "Replace the marked object with a red umbrella",
      "outputResolution": "720p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Seedance-Parameterreferenz

Vollständige Referenz aller inputs-Parameter für die Modelle sd2 / sd2-fast / sd2-mini / sd2.5.

Felder auf oberster Ebene der Anfrage: model (erforderlich), inputs (erforderlich), callBackUrl (optionale Webhook-URL).

Assets

Assets sind Bilder, Videos und Audiodateien, die einen Prüfprozess durchlaufen, bevor sie in Video-Generierungs-Tasks verwendet werden können. Laden Sie ein Asset hoch, warten Sie, bis es ACTIVE wird, und verwenden Sie dann seine asset://-URL in Ihren Tasks.

Asset hochladen

Zwei Möglichkeiten zum Hochladen: Senden Sie eine lokale Datei direkt (multipart/form-data), oder geben Sie eine öffentlich zugängliche HTTPS-URL an. In beiden Fällen wird das Asset automatisch verarbeitet und geprüft.

Methode A — direkter Datei-Upload (multipart/form-data)

Senden Sie eine lokale Datei, ohne dass ein Bild-Hosting erforderlich ist. Der Medientyp wird anhand der Datei-Bytes erkannt (der Dateinamenerweiterung wird nicht vertraut). Erlaubt: Bilder (jpg/png/webp/gif/bmp/tiff/heic), Videos (mp4/mov), Audio (wav/mp3). Max. 50MB pro Datei (Bild ≤30MB, Video ≤50MB, Audio ≤15MB).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@/path/to/photo.jpg" \
  -F "name=my-photo" \
  https://seegen.ai/api/v1/assets/upload

Methode B — per URL (application/json)

Falls die Datei bereits unter einer öffentlichen HTTPS-URL gehostet wird.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "type": "IMAGE",
    "name": "my-photo"
  }' \
  https://seegen.ai/api/v1/assets/upload

Upload-Antwort

{
  "assetId": 123,
  "volcAssetId": "asset-20260326-abc123",
  "type": "IMAGE",
  "status": "PROCESSING",
  "failReason": null,
  "url": "https://example.com/photo.jpg",
  "name": "my-photo",
  "createdAt": 1711234567890
}

Asset-Status abfragen

Fragen Sie den Prüfstatus eines Assets ab. Wenn der Status PROCESSING ist, prüft der Endpunkt automatisch auf Updates vom Prüfsystem.

# Query by asset ID (numeric)
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/status?assetId=123"

# Query by volcAssetId (string)
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/status?assetId=asset-20260326-abc123"

Assets auflisten

Listet Ihre hochgeladenen Assets mit optionaler Filterung nach Typ und Status auf. Unterstützt Cursor-basierte Paginierung.

# List all assets
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list"

# Filter by type and status
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list?type=IMAGE&status=ACTIVE&limit=10"

# Paginate with cursor
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list?cursor=100&limit=20"

Listen-Antwort

{
  "items": [
    {
      "assetId": 123,
      "volcAssetId": "asset-20260326-abc123",
      "type": "IMAGE",
      "status": "ACTIVE",
      "failReason": null,
      "url": "https://example.com/photo.jpg",
      "name": "my-photo",
      "width": 1920,
      "height": 1080,
      "size": 245000,
      "duration": null,
      "createdAt": 1711234567890
    }
  ],
  "nextCursor": 122
}

Assets in Tasks verwenden

Sobald ein Asset ACTIVE ist, verwenden Sie seine volcAssetId mit dem asset://-Protokoll in den URLs Ihres Tasks:

{
  "model": "sd2",
  "inputs": {
    "urls": ["asset://asset-20260326-abc123"],
    "prompt": "The person slowly looks up and smiles",
    "duration": "5s"
  }
}

HappyHorse 1.1 (Alibaba)

Ein alternatives Videogenerierungsmodell von Alibaba DashScope. Unterstützt drei Modi: Text-to-Video, Image-to-Video mit erstem Bild und Reference-to-Video (1–9 Referenzbilder werden pro Prompt zusammengeführt; verweisen Sie im Prompt mit character1, character2, … auf die Subjekte). HappyHorse 1.1 unterstützt kein letztes Bild, Referenzvideo oder Referenzaudio. Modellname: happyhorse.

Keine Asset-Prüfung erforderlich — Sie können öffentliche HTTPS-Bild-URLs direkt verwenden oder asset://-Referenzen aus der Asset-Bibliothek übergeben (werden automatisch wieder in die ursprüngliche R2-URL aufgelöst).

Text zu Video

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "prompt": "A panda DJ at a beach party, smoky sunset",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Video (erstes Bild)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "urls": ["https://example.com/panda.jpg"],
      "prompt": "The panda blinks and smiles",
      "duration": "5s",
      "outputResolution": "1080p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referenz zu Video (1–9 Referenzbilder)

Übergeben Sie videoWorkflowTab: "multi-reference" mit 1–9 Referenzbild-URLs, um mehrere Subjekte zu einer einzigen Ausgabe zusammenzuführen. Verweisen Sie im Prompt mit character1, character2, … auf jedes Bild (in der Reihenfolge von urls). Das Seitenverhältnis wird über das Feld ratio gesteuert (es gibt kein erstes Bild, aus dem es abgeleitet werden könnte).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "videoWorkflowTab": "multi-reference",
      "urls": [
        "https://example.com/character.jpg",
        "https://example.com/folding-fan.jpg",
        "https://example.com/earrings.jpg"
      ],
      "prompt": "A woman in red character1 opening folding fan character2, with tassel earrings character3 swinging",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

HappyHorse-Parameterreferenz

Vollständige Referenz aller inputs-Parameter für das Modell happyhorse.

Modell auswählen (Bild)

Bildmodelle nehmen einen Prompt (und optional Referenzbilder) entgegen und liefern ein Bild pro Task. Jede Anfrage wird pro Bild anhand der Stufe des gewählten Modells abgerechnet (oder zum Pauschalpreis bei Seedream Lite). Fehlgeschlagene Tasks werden automatisch erstattet. Es gibt keinen Batch-Parameter — um mehrere Varianten zu generieren, rufen Sie createTask einmal pro Bild auf.

GPT Image 2

Das GPT Image 2-Modell von OpenAI für hochwertiges Text-to-Image und Image-to-Image-Bearbeitung. Ein einziger Workflow deckt beide Modi ab — übergeben Sie urls, um automatisch in den Bearbeitungsmodus zu wechseln. Die Ausgabe wird über R2 im von Ihnen angeforderten Format (PNG / JPEG / WEBP) geliefert. Modellname: gpt-image-2.

Text zu Bild

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "quality": "medium",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Bild (Bearbeitung)

Übergeben Sie 1–10 Referenzbilder über urls. Das Modell verwendet sie als visuellen Kontext für die in prompt beschriebene Bearbeitung.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "quality": "medium",
      "resolution": "1k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

GPT Image 2-Parameterreferenz

Vollständige Referenz aller inputs-Parameter für das Modell gpt-image-2.

Die Credits pro Bild skalieren nach Auflösung und Qualität — die vollständige Tabelle finden Sie im Abschnitt Preise.

Nano Banana 2

Nano Banana 2 ist ein hochauflösendes Bildmodell mit breiterer Seitenverhältnis-Abdeckung als gpt-image-2 — fügt Hoch-/Querformat-Voreinstellungen (3:2, 2:3, 4:5, 5:4) und filmisches 21:9 hinzu. Ein einziger Workflow deckt beide Modi ab — übergeben Sie urls, um automatisch in den Bearbeitungsmodus zu wechseln. Modellname: nano-banana-2.

Text zu Bild

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Bild (Bearbeitung)

Übergeben Sie 1–10 Referenzbilder über urls. Das Modell verwendet sie als visuellen Kontext für die in prompt beschriebene Bearbeitung.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Nano Banana 2-Parameterreferenz

Vollständige Referenz aller inputs-Parameter für das Modell nano-banana-2.

Die Credits pro Bild skalieren nach Auflösung — die vollständige Tabelle finden Sie im Abschnitt Preise.

Nano Banana Pro

Nano Banana Pro ist ein hochauflösendes Bildmodell mit breiterer Seitenverhältnis-Abdeckung als gpt-image-2 — fügt Hoch-/Querformat-Voreinstellungen (3:2, 2:3, 4:5, 5:4) und filmisches 21:9 hinzu. Ein einziger Workflow deckt beide Modi ab — übergeben Sie urls, um automatisch in den Bearbeitungsmodus zu wechseln. Modellname: nano-banana-pro.

Text zu Bild

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Bild (Bearbeitung)

Übergeben Sie 1–10 Referenzbilder über urls. Das Modell verwendet sie als visuellen Kontext für die in prompt beschriebene Bearbeitung.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Nano Banana Pro-Parameterreferenz

Vollständige Referenz aller inputs-Parameter für das Modell nano-banana-pro.

Die Credits pro Bild skalieren nach Auflösung — die vollständige Tabelle finden Sie im Abschnitt Preise.

Seedream 5.0 Lite

Schnelle Text-to-Image- und Image-to-Image-Generierung bei 2K oder 4K mit 15 Seitenverhältnissen. Modellname: seedream-v5.0-lite.

Text zu Bild

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-lite",
    "inputs": {
      "prompt": "A cinematic product photograph, soft studio light",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Bild (Bearbeitung)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-lite",
    "inputs": {
      "prompt": "Restyle the references as a premium fashion campaign",
      "urls": ["https://example.com/reference.png"],
      "resolution": "4k",
      "aspectRatio": "3:4"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Seedream 5.0 Lite-Parameter

Seedream 5.0 Pro

Generierung und Bearbeitung in hoher Wiedergabetreue bei 1K oder 2K. Modellname: seedream-v5.0-pro.

Text zu Bild

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-pro",
    "inputs": {
      "prompt": "Editorial portrait with dramatic rim lighting",
      "resolution": "2k",
      "aspectRatio": "3:4"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Bild zu Bild (Bearbeitung)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-pro",
    "inputs": {
      "prompt": "Turn the reference into a cinematic poster",
      "urls": ["https://example.com/reference.png"],
      "resolution": "2k",
      "aspectRatio": "1:2"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Seedream 5.0 Pro-Parameter

Video-Upscaler

Task erstellen

POST /api/v1/upscale/create

# source.url accepts ANY https video URL — your own CDN, OR a file you first
# uploaded to us via /api/v1/assets/upload (pass the r2Url it returns). No need
# to declare which: we detect it. External URLs are validated; our own are trusted.
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "type": "url", "url": "https://your-cdn.com/video.mp4" },
    "targetResolution": "2k",
    "callBackUrl": "https://your-server.com/webhook"
  }' \
  https://seegen.ai/api/v1/upscale/create

Antwort auf Erstellung

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "orderId": "ord_2026...",
  "status": "validating"
}

Status abfragen

GET /api/v1/upscale/query?taskId=...

Der Status durchläuft validating → processing → completed / failed.

curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/upscale/query?taskId=n770mo4sh6rpi690ff3gwymx"

Antwort bei Abschluss

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "status": "completed",
  "targetResolution": "2k",
  "creditsConsumed": 900,
  "result": {
    "url": "https://static.seegen.ai/standalone-upscale/results/...mp4",
    "probedDurationSeconds": 30,
    "probedSourceResolution": "1280x720"
  },
  "error": null,
  "createdAt": "2026-04-29T01:23:45.000Z",
  "finishedAt": "2026-04-29T01:35:01.000Z"
}

Antwort bei Fehlschlag

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "status": "failed",
  "creditsConsumed": null,
  "result": null,
  "error": {
    "code": "SOURCE_RESOLUTION_TOO_HIGH",
    "message": "Source 3840x2160 is not below target 4k"
  }
}

Fehlercodes

Häufige Fehler, auf die Sie reagieren können. Andere Fehlschläge liefern ein selbsterklärendes Feld message — lesen Sie dieses, bevor Sie annehmen, dass der Code einer dieser hier ist.

Webhook-Callback

Statt zu pollen, können Sie eine callBackUrl angeben, um Ergebnisse automatisch zu erhalten, wenn ein Task abgeschlossen wird oder fehlschlägt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "callBackUrl": "https://your-server.com/webhook/callback",
    "inputs": {
      "prompt": "A cat playing piano",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Callback-Payload

Wenn der Task abgeschlossen ist, senden wir eine POST-Anfrage an Ihre URL im selben Format wie die queryTask-Antwort:

// POST to your callBackUrl
{
  "taskId": "task_abc123",
  "model": "sd2",
  "status": "COMPLETED",
  "creditsUsed": 200,
  "output": [
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

Antwortformat

createTask-Antwort

// 200 OK
{ "taskId": "task_abc123" }

queryTask-Antwort

{
  "taskId": "task_abc123",
  "model": "sd2",
  "status": "COMPLETED",     // "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED"
  "creditsUsed": 200,
  "output": [                // null when status is not "COMPLETED"
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,             // error message when status is "FAILED"
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

credits-Antwort

{
  "credits": 5000,
  "availableCredits": 4800
}

Fehlerbehandlung

Vorab-Validierung (400 mit Code)

Seedance-Anfragen werden vor jeglicher Belastung von Credits gegen den Upstream-Vertrag geprüft. Schlägt eine Prüfung fehl, gibt createTask { "message": "...", "code": "..." } mit HTTP 400 zurück, und es wird kein Task erstellt. Die Meldung gibt genau an, welches Limit überschritten wurde und wie es zu beheben ist.

Vollständige Beispiele

Vollständiger Workflow: Laden Sie ein Asset hoch, warten Sie auf die Prüfung, erstellen Sie einen Task mit dem freigegebenen Asset und fragen Sie das Ergebnis ab.

const API_KEY = process.env.API_KEY;
const BASE = "https://seegen.ai/api/v1";
const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Upload asset and wait for review
// (To upload a LOCAL file instead of a URL, POST multipart/form-data with a "file"
//  field — no Content-Type header, no "type" — see the Upload Asset section above.)
async function uploadAndWaitForAsset(url, type = "IMAGE") {
  const res = await fetch(`${BASE}/assets/upload`, {
    method: "POST",
    headers,
    body: JSON.stringify({ url, type }),
  });
  if (!res.ok) throw new Error(`Upload failed: ${(await res.json()).message}`);
  const asset = await res.json();
  console.log(`Asset uploaded: ${asset.assetId}, status: ${asset.status}`);

  // Poll until review completes
  while (true) {
    const statusRes = await fetch(
      `${BASE}/assets/status?assetId=${asset.assetId}`,
      { headers }
    );
    const status = await statusRes.json();
    if (status.status === "ACTIVE") {
      console.log(`Asset approved: asset://${status.volcAssetId}`);
      return status.volcAssetId;
    }
    if (status.status === "FAILED") {
      throw new Error(`Asset review failed: ${status.failReason}`);
    }
    await new Promise((r) => setTimeout(r, 3000));
  }
}

// 2. Create a task
async function createTask(inputs, callBackUrl) {
  const res = await fetch(`${BASE}/jobs/createTask`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      model: "sd2",
      inputs,
      ...(callBackUrl && { callBackUrl }),
    }),
  });
  if (!res.ok) throw new Error(`[${res.status}] ${(await res.json()).message}`);
  return res.json();
}

// 3. Poll until done
async function waitForResult(taskId, timeoutMs = 300000) {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const res = await fetch(
      `${BASE}/jobs/queryTask?taskId=${taskId}`,
      { headers }
    );
    const result = await res.json();
    if (result.status === "COMPLETED") return result;
    if (result.status === "FAILED") throw new Error(result.error);
    await new Promise((r) => setTimeout(r, 5000));
  }
  throw new Error("Timeout waiting for task");
}

// Full workflow: upload → review → generate → result
async function main() {
  // Upload image and wait for review
  const volcAssetId = await uploadAndWaitForAsset(
    "https://example.com/photo.jpg", "IMAGE"
  );

  // Create task with approved asset
  const { taskId } = await createTask({
    urls: [`asset://${volcAssetId}`],
    prompt: "The person slowly looks up and smiles",
    duration: "5s",
  });
  console.log(`Task: ${taskId}`);

  // Wait for video
  const result = await waitForResult(taskId);
  console.log(`Video: ${result.output[0].url}`);
}

main().catch(console.error);