curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-draft-to-video",
  "source_task_id": "task-unified-1774857405-abc123"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-draft-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 0
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

Seedance 2.5

Seedance 2.5 Draft-to-Video

Wandelt einen fertigen Seedance-2.5-Entwurf (eine mit draft: true erstellte Aufgabe) in ein finales 1080p-Video mit demselben Inhalt um
Es werden nur vier Felder akzeptiert: model, source_task_id, output_format und callback_url. Prompt, Materialien, Dauer, Seitenverhältnis, Seed und Audioeinstellungen werden vollständig vom Entwurf übernommen. Diese Felder dürfen nicht erneut übergeben werden; jedes andere Feld führt zu einem 400-Parameterfehler
Senden Sie die Konvertierungsanfrage vor draft_expires_at des Entwurfs. Die Gültigkeitsdauer beträgt standardmäßig 24 Stunden ab Fertigstellung des Entwurfs; maßgeblich ist der tatsächliche Wert von draft_expires_at aus der Aufgabenabfrage
Die Gültigkeit wird sowohl bei Annahme der Anfrage als auch vor Übergabe zur Generierung geprüft. Läuft der Entwurf in der Warteschlange ab, schlägt die Konvertierungsaufgabe fehl und ihre Kosten werden erstattet. Planen Sie daher Wartezeit ein
Derselbe Entwurf kann innerhalb seiner Gültigkeitsdauer mehrfach konvertiert werden; jede Konvertierung wird separat abgerechnet
Asynchroner Verarbeitungsmodus: Verwenden Sie die zurückgegebene Aufgaben-ID zur Statusabfrage. Die Antwort enthält source_task_id
Generierte Video-Links sind 24 Stunden gültig; speichern Sie die Dateien rechtzeitig

Abrechnungsregeln:

Wird separat vom Entwurf und immer zum 1080p-Tarif abgerechnet
Als Ausgabedauer gilt die für den Quellentwurf gespeicherte tatsächliche Ausgabedauer. Fehlt dieser Wert, wird die für die Quellaufgabe gespeicherte effektive Ausgabedauer verwendet
Abrechenbare Dauer: ohne Videoeingabe die Ausgabedauer; mit Videoeingabe (einschließlich Reference-to-Video, Video Edit und Video Extend) Ausgabedauer + max(Eingabevideodauer, Ausgabedauer). In beiden Fällen wird auf die nächste 0,1 Sekunde aufgerundet
War der Inhaltsfilter für den Entwurf deaktiviert (content_filter: false), wird auch das finale Video mit +10 % (1.1x) abgerechnet
Schlägt die Konvertierung fehl, werden die Kosten dieser Konvertierung erstattet; die Kosten des Entwurfs werden nicht erstattet

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-draft-to-video",
  "source_task_id": "task-unified-1774857405-abc123"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-draft-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 0
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token##

API Key erhalten:

Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhalten

Fügen Sie ihn im Anfrage-Header hinzu:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:seedance-2.5-draft-to-video

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

seedance-2.5-draft-to-video

Beispiel:

"seedance-2.5-draft-to-video"

source_task_id

string

erforderlich

Aufgaben-ID eines fertigen Seedance-2.5-Entwurfs

Wo Sie die ID finden: Im Feld id der Antwort beim Erstellen eines Entwurfs (draft: true)

Voraussetzungen:

Die Aufgabe muss zum aktuellen Konto gehören
Die Aufgabe muss eines der fünf Seedance-2.5-Generierungsmodelle verwenden
Die Aufgabe muss mit draft: true erstellt worden sein
Der Aufgabenstatus muss completed sein
Die aktuelle Zeit muss vor draft_expires_at aus der Aufgabenabfrage liegen

Beispiel:

"task-unified-1774857405-abc123"

output_format

enum<string>

Standard:mp4

Ausgabe-Containerformat, Standard ist mp4

Verfügbare Werte:

mp4: Standard-Containerformat. Dieser Endpunkt gibt 1080p-Videos mit 10-Bit-Farbtiefe und H.265/HEVC-Kodierung aus. Für die Wiedergabe ist Unterstützung für 10-Bit-HEVC erforderlich; reine H.264-Player können das Video möglicherweise nicht abspielen
mov: H.264 + yuv444p-Chroma-Sampling + PCM-Audio für höhere Farbtreue, empfohlen für Color-Grading-, Keying- und Compositing-Workflows. Die Wiedergabe im Browser wird möglicherweise nicht unterstützt; laden Sie die Datei herunter und spielen Sie sie mit VLC / mpv / ffplay ab. Keine zusätzlichen Kosten

Das Ausgabeformat des Entwurfs wird nicht übernommen. Geben Sie hier bei Bedarf mov an

Verfügbare Optionen:

mp4,

mov

Beispiel:

"mp4"

callback_url

string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

Wird bei Aufgabenabschluss (completed) oder Fehler (failed) ausgelöst
Wird nach Bestätigung der Abrechnung gesendet

Sicherheitseinschränkungen:

Nur HTTPS-Protokoll unterstützt
Callbacks an interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
URL-Länge maximal 2048 Zeichen

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche nach Fehler (jeweils nach 1/2/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Rückgabeformat der Aufgabenabfrage-Schnittstelle
Ein 2xx-Statuscode gilt als Erfolg, andere Statuscodes lösen Wiederholungsversuche aus

Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Aufgabe zur Konvertierung in ein finales Video erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1761313744

string

Aufgaben-ID

Beispiel:

"task-unified-1774857405-abc123"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"seedance-2.5-draft-to-video"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

video.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Detaillierte Informationen zur Videoaufgabe

Show child attributes

type

enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Seedance 2.5 Draft-to-Video

Autorisierungen

Body

Antwort