Seedance 2.0 Mini

Funktionen

Preise & Credits

Die Videogenerierung wird in Credits auf Basis der abrechenbaren Dauer in Sekunden abgerechnet. Ohne Video-Input entspricht die abrechenbare Dauer der Ausgabedauer; mit Video-Input umfasst sie zusätzlich die Dauer des Referenzvideos.

In der folgenden Tabelle sind die berechneten Credits pro Sekunde aufgeführt, nicht die Gesamtkosten eines Auftrags. Die Rate hängt vom Modell, der Ausgabeauflösung und der Frage ab, ob im Referenz-zu-Video-Modus Referenzvideos bereitgestellt werden. Die Formeln und Beispiele unter der Tabelle zeigen, wie sich die Gesamtkosten berechnen.

• Ohne Video-Input: Ausgabesekunden × Tarif ohne Video.
• Mit Video-Input: (Ausgabesekunden + gemessene Referenzvideo-Sekunden) × Tarif mit Video. Der Server misst die Gesamtdauer des Referenzvideos und rundet sie vor der Abrechnung auf ganze Sekunden auf.
• Reine Bild- oder Audioreferenzen nutzen den Tarif ohne Video. Der Tarif für Referenzvideos gilt nur im Reference-to-Video-Modus, wenn tatsächlich Videoreferenzen übergeben werden.

Credits werden bei der Übermittlung reserviert und bei Erfolg abgebucht. Fehlgeschlagene Tasks oder Timeouts gehen in den Rückerstattungsprozess. Der Abrechnungsstatus refund_failed bedeutet, dass die Rückerstattung nicht abgeschlossen werden konnte; prüfen Sie die API-Protokolle oder kontaktieren Sie den Support.

Authentifizierung

Erstellen Sie einen API-Key im Dashboard. Der vollständige Key wird nur einmal angezeigt. Speichern Sie ihn auf Ihrem Server und senden Sie ihn bei jeder Anfrage als Bearer-Token mit.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Setzen Sie die Umgebungsvariable SEEVIO_API_KEY, bevor Sie diese Beispiele ausführen. JavaScript-Beispiele laufen mit Node.js auf Ihrem Server; Python-Beispiele nutzen das requests-Paket.

Schnellstart

Senden Sie diese minimale Anfrage, speichern Sie die zurückgegebene taskId und nutzen Sie das untenstehende Beispiel zur Task-Abfrage. Der Credits-Wert in der Erstellungsantwort entspricht dem reservierten Betrag.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Beispiel für die Antwort beim Erstellen eines Tasks

Nach der Annahme der oben genannten Anfrage gibt die API diese JSON-Antwort zurück. taskId ist die Aufgabenkennung für nachfolgende Statusabfragen; credits ist die Anzahl der für diese Aufgabe reservierten Credits. Diese Antwort bestätigt lediglich die Erstellung der Aufgabe, nicht die Fertigstellung des Videos. Sie müssen den Status der Aufgabe abfragen (Polling) oder einen Webhook verwenden, um die Videoergebnisse zu erhalten.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 30
}

Task erstellen

Senden Sie ein JSON-Objekt mit model und input sowie einer optionalen callback_url. Geben Sie immer die auf dieser Seite gezeigte Modell-ID an; wird model weggelassen, wird standardmäßig seedance-2-0 gewählt.

Request-Body

Eingabeparameter

Geben Sie image_urls, video_urls und audio_urls als Arrays von URL-Strings (string[]) an. Jede angegebene URL muss öffentlich über HTTPS erreichbar sein – dies gilt auch für Medien, die im ausgewählten Modus ignoriert werden.

Boolesche Felder müssen als JSON-Werte true oder false übergeben werden, nicht als Strings oder Zahlen.

Antwort bei Erstellung

HTTP 200 gibt die taskId (String) und credits (Zahl) zurück. Dies bestätigt die Erstellung des Tasks, nicht dessen Fertigstellung. Der unten stehende Betrag entspricht dem 5-sekündigen 720p-Schnellstart.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 30
}

Generierungsmodi & Beispiele

Text-to-Video

Aus einem Text-Prompt generieren. Medien-URLs werden in diesem Modus nicht weitergeleitet.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Erster Frame

Geben Sie ein Bild als ersten Frame an und beschreiben Sie die Bewegung in Ihrem Prompt.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Erster und letzter Frame

Geben Sie zwei Bild-URLs in der richtigen Reihenfolge an: zuerst der erste, dann der letzte Frame. Dieses Beispiel fordert auch den letzten Frame des generierten Videos an.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Multimodale Referenz

Kombinieren Sie Bild-, Video- und Audioreferenzen. Der Prompt ist weiterhin erforderlich. Die Übergabe eines Referenzvideos ändert die Abrechnungsformel.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Task abfragen

Ersetzen Sie die Beispiel-ID durch die bei der Erstellung zurückgegebene taskId. Abfragen liefern nur Tasks zurück, die dem User des API-Keys gehören; bei unzugänglichen oder unbekannten IDs wird HTTP 404 zurückgegeben.

Fragen Sie anfangs alle 10–20 Sekunden ab, drosseln Sie die Frequenz bei HTTP 429 und stoppen Sie, sobald der Status completed oder failed lautet. Nutzen Sie für die Produktion bevorzugt Webhooks. Jedes Codebeispiel unten führt eine einzelne Abfrage aus.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

Abgeschlossener Task: Abfrage-Antwort mit Video-Ergebnissen

Wenn die Abfrage status=completed zurückgibt, ist die Videogenerierung abgeschlossen. Rufen Sie die Video-URLs aus data.results ab und laden Sie diese vor data.video_expires_at herunter. billing_status=charged zeigt an, dass die reservierten Credits abgebucht wurden.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "completed",
  "billing_status": "charged",
  "credits": 30,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Fehlgeschlagener Task: Abfrage-Antwort mit Fehler- und Abrechnungsdetails

Wenn die Abfrage status=failed zurückgibt, wurde die Generierung erfolglos beendet. Unter failed_reason finden Sie die Ursache und unter billing_status das Erstattungsergebnis. In diesem Beispiel bedeutet refunded, dass die Credits zurückerstattet wurden. credits behält den ursprünglich reservierten Betrag bei, und die Antwort enthält keine data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "failed",
  "billing_status": "refunded",
  "credits": 30,
  "failed_reason": "provider_failed"
}

Webhooks

Setzen Sie callback_url in der Erstellungsanfrage, um einen JSON-POST zu erhalten, sobald der Task abgeschlossen ist oder fehlschlägt. Antworten Sie innerhalb von 15 Sekunden mit einem 2xx-Statuscode. Fehlgeschlagene Zustellungen werden wiederholt; verarbeiten Sie doppelte Zustellungen idempotent anhand der Task-ID.

Ihr Callback-Endpunkt muss POST-Anfragen mit einem JSON-Body (Content-Type: application/json) akzeptieren.

Task mit Callback erstellen

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Webhook-Payloads unterscheiden sich von den Antworten der Task-Abfrage: billing_status und credits fehlen; Fehlerdetails befinden sich in data.failed_reason und data.credits_refunded. Das Feld created_at im Webhook entspricht der Event-Erstellungszeit in Unix-Sekunden.

Task abgeschlossen: Payload für erfolgreichen Callback

Wenn die Generierung erfolgreich war, enthält der Callback status=completed. Verwenden Sie id zur Identifizierung des Tasks und data.results, um die Video-URLs abzurufen. Laden Sie die Ergebnisse vor data.video_expires_at herunter und speichern Sie diese.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Task fehlgeschlagen: Payload für fehlgeschlagenen Callback

Wenn die Generierung fehlschlägt, enthält der Callback status=failed. Verwenden Sie id zur Identifizierung des Tasks, data.failed_reason für die Fehlerursache und data.credits_refunded für die Anzahl der erstatteten Credits.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "failed",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 30
  }
}

Empfänger-Beispiel

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData.data;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Dieses Next.js-Beispiel liest den JSON-Callback-Body aus und verarbeitet erfolgreiche sowie fehlgeschlagene Tasks direkt. Fügen Sie für Ihre eigene Anwendung Datenpersistenz und Task-ID-Deduplizierung hinzu. Stellen Sie zeitaufwendige Prozesse in eine Warteschlange, bevor Sie den Callback bestätigen.

Medienanforderungen & Einschränkungen

• Alle Medien- und Callback-URLs müssen öffentliche HTTPS-URLs sein. Vermeiden Sie localhost, private IPs und Dateien, die Cookies oder Logins erfordern. Referenz-URLs für Video/Audio müssen direkt lesbare Mediendateien ausgeben.
• Geben Sie bei reference-to-video mindestens eine Referenz an, mit maximal 9 Bildern, 3 Videos, 3 Audiodateien und insgesamt 12 Dateien. Die Gesamtdauer der Videos und der Audios darf jeweils maximal 15 Sekunden betragen.
• text-to-video ignoriert alle Medienreferenzen. image-to-video übernimmt nur das erste/letzte Bild und ignoriert Video- und Audioreferenzen. Nutzen Sie reference-to-video, um verschiedene Medien zu kombinieren.
• Verwenden Sie bei Seedance 2.0-Modellen aus Kompatibilitätsgründen Audio immer zusammen mit mindestens einem Bild oder Video. Reine Audio-Beispiele finden Sie auf der Seite für Seedance 2.5.
• Fast und Mini unterstützen 480p und 720p. Verlassen Sie sich nicht darauf, dass höhere Auflösungs-Strings bei der Validierung akzeptiert werden: Sie sind für dieses Modell nicht freigeschaltet.

Fehler

HTTP-Fehler enthalten ein error-Objekt mit code und message. Auch ein erfolgreich angenommener Task kann später noch fehlschlagen; fragen Sie den Task ab oder verarbeiten Sie den Callback für Fehler.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

Rate Limits

Tasks erstellen: Pro API-Schlüssel sind standardmäßig bis zu 100 Anfragen pro Minute zulässig. Individuelle Ratenbegrenzungen sind derzeit nicht verfügbar.

Tasks abfragen: Pro API-Schlüssel sind standardmäßig bis zu 120 Anfragen pro Minute zulässig. Abfragen und Erstellungsanfragen werden separat gezählt.