Seedance 2.5 Flash
Generieren Sie Videos mit Seedance 2.5 Flash mithilfe von Text, ersten und letzten Frames oder multimodalen Referenzen. Diese Seite beschreibt den gesamten Workflow von der Anfrage bis zum Ergebnis für dieses Modell.
API-Modell-ID: seedance-2-5-flash
Die Generierung erfolgt asynchron. Speichern Sie die beim Erstellen des Tasks zurückgegebene taskId, um den Status abzufragen oder einen Webhook zu empfangen.
Funktionen
| Feature | Unterstützte Werte |
|---|---|
| Ausgabeauflösung | 480p · 720p |
| Ausgabedauer | 4–30 Sekunden |
| Seitenverhältnis | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive |
| Referenzbilder | Bis zu 30 Bilder |
| Referenzvideos | Bis zu 10 Videos |
| Referenzaudiodateien | Bis zu 10 Audiodateien |
| Alle Referenzen kombiniert | Insgesamt bis zu 50 Referenzdateien |
| Gesamtdauer pro Video-/Audio-Gruppe | 30 Sekunden |
| seed | -1 bis 2147483647 |
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.
| Ausgabeauflösung | Ohne Video-Input | Mit Video-Input |
|---|---|---|
480p | 7 Credits/Sekunde | 5 Credits/Sekunde |
720p | 10 Credits/Sekunde | 7 Credits/Sekunde |
- 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.
Abrechnungsbeispiele
5 Sekunden 720p Text-to-Video: 5 × 10 = 50 Credits.
5 Sekunden 720p Ausgabe mit einem 5-sekündigen Referenzvideo: (5 + 5) × 7 = 70 Credits.
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.
Credit-Abrechnung bei duration=-1
Wenn die Dauer auf -1 festgelegt ist, ist die endgültige Videolänge nicht vordefiniert, sondern wird direkt vom Modell bestimmt.
In den meisten Fällen ist es ratsam, die tatsächlich benötigte Videolänge anstelle von -1 einzustellen. Wir empfehlen, den Wert -1 ausschließlich für die Videobearbeitung und nicht für andere Szenarien der Videogenerierung zu verwenden.
| Referenz-Inputs | Berechnung der Gebühr | Beispiel |
|---|---|---|
| Mit Referenzvideos | Die Dauer aller Referenzvideos wird addiert und auf die nächste ganze Sekunde aufgerundet (Wert T). Die Gebühr berechnet sich nach der Formel (T + T) × Tarif mit Video: Das erste T steht für die geschätzte Ausgabelänge, das zweite für die Dauer des Input-Videos. | 720p mit einem 5-sekündigen Referenzvideo: (5 + 5) × 7 = 70 Credits. |
| Ohne Referenzvideos (nur Bilder oder Audio) | Als geschätzte Ausgabelänge werden pauschal 30 Sekunden veranschlagt. Die Gebühr beträgt somit 30 × Tarif ohne Video. | 720p ohne Referenzvideos: 30 × 10 = 300 Credits. |
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.
Basis-URL
https://api.seevio.aiAuthorization: Bearer sk_live_your_api_key
Content-Type: application/jsonSetzen 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-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"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": 50
}Task erstellen
POST https://api.seevio.ai/v1/videos/generationsSenden Sie ein JSON-Objekt, das model und input sowie optional eine Callback-URL (callback_url) enthält. Geben Sie immer die auf dieser Seite angezeigte Modell-ID an. Wird kein Modell angegeben, wird standardmäßig seedance-2-0 ausgewählt.
Request-Body
| Feld | Typ | Erforderlich | Beschreibung & Einschränkungen |
|---|---|---|---|
model | string | Ja | Modell-ID. Um Seedance 2.5 Flash zu verwenden, setzen Sie dieses Feld auf seedance-2-5-flash. |
callback_url | string | Nein | Öffentlicher HTTPS-Endpunkt für POST-Callbacks bei Fertigstellung oder Fehlern. Private Netzwerke und localhost sind nicht erlaubt. Beispiel: https://example.com/webhooks/seevio |
input | object | Ja | Generierungseinstellungen. Muss einen ausgefüllten Prompt enthalten. |
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.
| Feld | Typ | Erforderlich | Standard | Beschreibung & Einschränkungen |
|---|---|---|---|---|
input.prompt | string | Ja | — | Für jeden Modus ist eine Eingabe (Prompt) erforderlich. Diese darf gekürzt maximal 10.000 Zeichen lang sein und darf nicht ausschließlich aus Leerzeichen bestehen. Beispiel: A cat surfing at sunset |
input.generation_type | string | Nein | text-to-video | Unterstützte Werte text-to-video | image-to-video | reference-to-videotext-to-video, image-to-video oder reference-to-video. Wenn weggelassen, wird standardmäßig text-to-video verwendet und nur der Prompt berücksichtigt. image-to-video benötigt 1–2 geordnete Frame-Bilder. reference-to-video nutzt Bilder, Videos und/oder Audio; reine Audio-Referenzen sind in Kombination mit einem erforderlichen Prompt zulässig. |
input.image_urls | string[] | Bedingt | [] | Übergeben Sie Bild-URLs, um den visuellen Stil zu steuern. Bei image-to-video: 1 Bild für den ersten Frame oder 2 in der Reihenfolge Erster/Letzter Frame. Bei reference-to-video: maximal 30 Bilder. Jedes Bild muss kleiner als 30 MB sein; Details zu Formaten und Maßen finden Sie in den Medienanforderungen unten. Alle Referenztypen zusammen dürfen maximal 50 Dateien umfassen. Standardwert bei Auslassung ist []. Wird bei text-to-video ignoriert. Beispiel: ["https://example.com/first-frame.jpg"] |
input.video_urls | string[] | Bedingt | [] | Übergeben Sie Referenzvideo-URLs zur Bewegungssteuerung oder zur Bearbeitung/Verlängerung eines Videos (nur im Modus reference-to-video). Maximal 10 Dateien, jeweils bis zu 100 MB und 2–30 Sekunden lang; die Gesamtdauer darf 30 Sekunden nicht überschreiten. Alle Referenztypen zusammen dürfen maximal 50 Dateien umfassen. Der Server misst die Videodauer für die Abrechnung. Standardwert bei Auslassung ist []. Wird in anderen Modi ignoriert. Beispiel: ["https://example.com/source.mp4"] |
input.audio_urls | string[] | Bedingt | [] | Übergeben Sie Referenzaudio-URLs zur Tonsteuerung (nur im Modus reference-to-video). Maximal 10 MP3/WAV-Dateien, jeweils bis zu 15 MB und 2–30 Sekunden lang; die Gesamtdauer darf 30 Sekunden nicht überschreiten. Alle Referenztypen zusammen dürfen maximal 50 Dateien umfassen. Audio kann als einzige Referenz übergeben werden; ein Prompt ist weiterhin erforderlich. Standardwert bei Auslassung ist []. Wird in anderen Modi ignoriert. Beispiel: ["https://example.com/music.mp3"] |
input.duration | integer | Nein | 5 | Unterstützte Werte -1 | 4–30Ganzzahlige Ausgabedauer von 4 bis 30 Sekunden. Akzeptiert zudem -1 (ausschließlich bei reference-to-video). Nutzen Sie dies mit einem Quellvideo zur Bearbeitung; die Abrechnung folgt der oben genannten Sonderregel. Beispiel: 5 |
input.aspect_ratio | string | Nein | adaptive | Unterstützte Werte 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9, 4:3, 1:1, 3:4, 9:16, 21:9 oder adaptive. Wenn weggelassen, wird standardmäßig adaptive verwendet, wodurch das Modell das Ausgabeformat bestimmt. Verwenden Sie für Videobearbeitung oder -verlängerung adaptive. image-to-video unterstützt nur adaptive; lassen Sie dieses Feld weg oder setzen Sie es auf adaptive. Beispiel: adaptive |
input.resolution | string | Nein | 720p | Unterstützte Werte 480p | 720p480p oder 720p. Wenn weggelassen, wird in jedem unterstützten Generierungsmodus standardmäßig 720p verwendet. Höhere Auflösungen werden abgelehnt. Beispiel: 720p |
input.generate_audio | boolean | Nein | true | Unterstützte Werte true | falseBei true wird synchronisierter Ton generiert; false deaktiviert die Audiogenerierung. Wenn weggelassen, ist der Standardwert true. Gilt für alle unterstützten Generierungsmodi. Beispiel: true |
input.watermark | boolean | Nein | false | Unterstützte Werte true | falsetrue fordert ein KI-Wasserzeichen im Ausgabevideo an; false fordert die Ausgabe ohne dieses Wasserzeichen an. Wenn weggelassen, ist der Standardwert false. Gilt für alle unterstützten Generierungsmodi. Beispiel: false |
input.web_search | boolean | Nein | false | Unterstützte Werte true | falseBei true wird die Websuche erlaubt, sofern das Modell dies unterstützt; false deaktiviert sie. Wenn weggelassen, ist der Standardwert false. Die Aktivierung garantiert nicht, dass tatsächlich eine Suche durchgeführt wird. Beispiel: false |
input.return_last_frame | boolean | Nein | false | Unterstützte Werte true | falseBei true wird der letzte Frame des generierten Videos separat angefordert; bei false nicht. Wenn weggelassen, ist der Standardwert false. Gilt für alle unterstützten Generierungsmodi. Falls angefordert und verfügbar, wird die URL als data.last_frame_url zurückgegeben, andernfalls als null. Beispiel: true |
input.seed | integer | Nein | — | Unterstützte Werte -1 bis 2147483647Ganzzahl von -1 bis 2147483647. Bei -1 wird ein zufälliger Seed gewählt. Beispiel: 42 |
input.output_format | string | Nein | mp4 | Unterstützte Werte mp4 | movmp4 oder mov. Wenn weggelassen, wird standardmäßig mp4 verwendet. Bestimmt das Containerformat der Ausgabe in allen unterstützten Generierungsmodi. |
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": 50
}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-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"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-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"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-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"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-5-flash",
"input": {
"prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
"duration": 5,
"resolution": "720p",
"seed": 42,
"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"
}
}'Audio-Referenz
Nutzen Sie Audio als einzige Referenz, zusammen mit einem erforderlichen Text-Prompt, der das gewünschte Video beschreibt.
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-5-flash",
"input": {
"prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"audio_urls": [
"https://example.com/music.mp3"
]
}
}'Videobearbeitung
Beschreiben Sie die gewünschte Bearbeitung und stellen Sie das Quellvideo bereit. Setzen Sie duration=-1 und verwenden Sie ein adaptives Seitenverhältnis. Nutzen Sie für diesen Workflow einen Quellclip von mindestens 4 Sekunden. Die Abrechnungsregel für duration=-1 finden Sie oben.
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-5-flash",
"input": {
"prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
"duration": -1,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"video_urls": [
"https://example.com/source.mp4"
],
"aspect_ratio": "adaptive"
}
}'Video-Erweiterung
Beschreiben Sie, wie das Quellvideo fortgesetzt werden soll. Nutzen Sie ein adaptives Seitenverhältnis und legen Sie eine normale Ausgabedauer innerhalb des Modellbereichs fest.
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-5-flash",
"input": {
"prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
"duration": 8,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"video_urls": [
"https://example.com/source.mp4"
],
"aspect_ratio": "adaptive"
}
}'Task abfragen
GET https://api.seevio.ai/v1/tasks/{taskId}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"| Status | Beschreibung & Einschränkungen |
|---|---|
queued | Akzeptiert und wartet auf die Verarbeitung. |
generating | Generierung läuft. |
completed | Erfolgreich abgeschlossen. Laden Sie data.results vor dem Ablaufdatum herunter. |
failed | Fehlgeschlagen. Prüfen Sie failed_reason und billing_status. |
| Feld | Typ | Beschreibung & Einschränkungen |
|---|---|---|
id | string | Task-ID. Entspricht der taskId aus der Erstellungsantwort. |
created_at | number | Erstellungszeitpunkt des Tasks als Unix-Zeitstempel (Sekunden). |
model | string | Die für diesen Task verwendete öffentliche Modell-ID. |
billing_status | string | reserved, charged, refunded oder refund_failed. |
credits | number | Für diesen Task reservierte Credits. Dieser Wert bleibt auch nach einer Rückerstattung erhalten; prüfen Sie billing_status, um das genaue Abrechnungsergebnis zu sehen. |
failed_reason | string | null | Fehlerursache bei fehlgeschlagenen Tasks; andernfalls null. Fehlgeschlagene Abfrage-Antworten enthalten keine data. |
data | object | Vorhanden bei erfolgreich abgeschlossenen oder laufenden Tasks. Enthält die Ausgabe und Verarbeitungsdetails. |
data.results | string[] | Array mit Video-URLs. Leer bis zur Fertigstellung oder nach Ablauf des Videos. |
data.video_expires_at | string | null | Ablaufdatum des Videos als ISO 8601-Zeitstempel, oder null, solange es noch nicht verfügbar ist. Speichern Sie das Ergebnis vor diesem Zeitpunkt. |
data.last_frame_url | string | null | URL des letzten Frames, sofern angefordert und verfügbar, andernfalls null. |
data.processing_time | number | null | Dauer der Aufgabenverarbeitung in Sekunden, falls verfügbar, andernfalls null. |
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-5-flash",
"is_draft": false,
"draft_task_id": null,
"status": "completed",
"billing_status": "charged",
"credits": 50,
"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-5-flash",
"is_draft": false,
"draft_task_id": null,
"status": "failed",
"billing_status": "refunded",
"credits": 50,
"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-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "text-to-video",
"aspect_ratio": "16:9",
"generate_audio": true
},
"callback_url": "https://example.com/webhooks/seevio"
}'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.
created_at ist die Ereigniszeit, task_created_at die Erstellungszeit der Aufgabe, jeweils in Unix-Sekunden. Die Beispiele zeigen empfohlene Felder; Antworten können weitere Felder enthalten.
{
"id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"created_at": 1788652848,
"model": "seedance-2-5-flash",
"status": "completed",
"task_created_at": 1788652800,
"billing_status": "charged",
"credits": 50,
"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
}
}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, failed_reason für die Fehlerursache und credits_refunded für die Anzahl der erstatteten Credits.
{
"id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"created_at": 1788652848,
"model": "seedance-2-5-flash",
"status": "failed",
"task_created_at": 1788652800,
"billing_status": "refunded",
"credits": 50,
"failed_reason": "provider_failed",
"credits_refunded": 50
}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;
// 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 30 Bildern, 10 Videos, 10 Audiodateien und insgesamt 50 Dateien. Die Gesamtdauer der Videos und der Audios darf jeweils maximal 30 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.
- Jedes Referenzvideo und jede Audiodatei muss zwischen 2 und 30 Sekunden lang sein. Verwenden Sie für Videobearbeitungsbeispiele Quellclips von mindestens 4 Sekunden.
Anforderungen für Bilder
- Die Dateigröße pro Bild darf maximal 30 MB betragen.
- Unterstützte Formate: jpeg, png, webp, bmp, tiff, gif.
- Seitenverhältnis (Breite ÷ Höhe): 0,4 bis einschließlich 2,5.
- Breite und Höhe müssen jeweils zwischen 300 und 6.000 Pixeln liegen.
Anforderungen für Videos
- Unterstützte Formate: mp4, mov.
- Die Dateigröße pro Video darf 100 MB nicht überschreiten.
- Bildrate: 24 bis einschließlich 60 FPS.
- Seitenverhältnis (Breite ÷ Höhe): 0,4 bis einschließlich 2,5.
- Gesamtpixelzahl (Breite × Höhe): 407.696 bis einschließlich 8.295.044. Zum Beispiel: 614 × 664 = 407.696 und 3.326 × 2.494 = 8.295.044. Dies sind lediglich Beispiele für die Pixelanzahl, keine festen Vorgaben für Breite und Höhe.
Anforderungen für Audiodateien
- Unterstützte Formate: wav, mp3.
- Die Dateigröße pro Audiodatei darf maximal 15 MB betragen.