curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-image-to-video",
  "prompt": "The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood.",
  "image_start": "https://example.com/first_frame.png",
  "duration": 5,
  "quality": "720p"
}
'

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

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan3.0-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Wan3.0

Wan3.0 Image-to-Video

Mit image_start wird das erste Bild des Videos streng festgelegt; mit zusätzlichem image_end auch das letzte Bild
Referenzmaterial wird nicht akzeptiert (Referenzvideos / Referenzaudio / Dateien / Webseiten): Start-/Endbild und Referenzmaterial schließen sich gegenseitig aus. Für gemischte Referenzen verwenden Sie Wan3.0 Reference-to-Video
Höchstens 2 Bilder (Startbild + Endbild). Für 3 oder mehr Referenzbilder verwenden Sie Reference-to-Video
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Task-ID für die Statusabfrage
Generierte Videolinks sind 24 Stunden gültig, bitte zeitnah speichern

Abrechnung

Abrechnungsformel: abgerechnete Dauer = Dauer des Eingabevideos + Dauer des Ausgabevideos, sekundengenaue Abrechnung
Auflösungsmultiplikator: 480p = 1x (Basis), 720p = 2x, 1080p = 4x
Referenzbilder, Referenzaudio, Referenzdateien und Weblinks werden nicht abgerechnet
Bei duration = -1 (intelligente Dauer) wird zum Höchstwert von 30 Sekunden vorab reserviert; nach erfolgreicher Aufgabe wird nach der tatsächlichen Ausgabedauer abgerechnet und die Differenz automatisch zurückerstattet
Das Ein- oder Ausschalten der audio-Spur kostet gleich viel
Fehlgeschlagene Aufgaben werden nicht abgerechnet, das eingefrorene Guthaben wird vollständig zurückerstattet

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": "wan3.0-image-to-video",
  "prompt": "The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood.",
  "image_start": "https://example.com/first_frame.png",
  "duration": 5,
  "quality": "720p"
}
'

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

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan3.0-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

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:wan3.0-image-to-video

erforderlich

Modellname, fest auf wan3.0-image-to-video

Verfügbare Optionen:

wan3.0-image-to-video

Beispiel:

"wan3.0-image-to-video"

image_start

string<uri>

erforderlich

URL des Startbilds, wird streng als erstes Bild des generierten Videos verwendet. Erforderlich

Bildgrenzen:

Formate: JPEG, JPG, PNG (Transparenz nicht unterstützt), BMP, WEBP
Auflösung: Breite und Höhe in [240, 8000] Pixel
Seitenverhältnis: 1:8 ~ 8:1
Dateigröße: max. 20MB

Beispiel:

"https://example.com/first_frame.jpg"

prompt

string

Text-Prompt für die Videogenerierung. Chinesisch und Englisch werden unterstützt, jedes chinesische Zeichen / jeder Buchstabe zählt als 1 Zeichen, maximale Länge 20000 Zeichen; alles darüber hinaus wird automatisch abgeschnitten (ohne Fehler)

Beschreiben Sie damit die Bewegung, Kameraführung und Bildveränderung, die zwischen Startbild (bzw. Start- und Endbild) erwartet wird.

Beispiel:

"A young girl's smile gradually turns into a big laugh, the camera slowly pushes in, and the background light shifts from cool tones to warm tones."

image_end

string<uri>

URL des Endbilds, wird streng als letztes Bild des generierten Videos verwendet. Optional

Einschränkung: muss zusammen mit image_start verwendet werden, nur ein Endbild zu übergeben wird nicht unterstützt.

Bildgrenzen:

Formate: JPEG, JPG, PNG (Transparenz nicht unterstützt), BMP, WEBP
Auflösung: Breite und Höhe in [240, 8000] Pixel
Seitenverhältnis: 1:8 ~ 8:1
Dateigröße: max. 20MB

Beispiel:

"https://example.com/last_frame.jpg"

duration

integer

Standard:5

Dauer des generierten Videos (Sekunden), Standard 5

Zulässige Werte:

Eine beliebige ganze Zahl zwischen 2 und 30
-1: intelligente Dauer, das Modell bestimmt die Ausgabelänge anhand von Prompt und Eingabematerial

Abrechnung der intelligenten Dauer: Bei der Übermittlung ist nicht bekannt, wie lang das Ergebnis wird, daher wird zum Höchstwert von 30 Sekunden vorab reserviert; nach erfolgreicher Aufgabe wird nach der tatsächlichen Ausgabedauer abgerechnet und der zu viel eingefrorene Anteil automatisch freigegeben. Reicht das Guthaben für die volle Reservierung nicht aus, geben Sie stattdessen eine konkrete Sekundenzahl an.

Beispiel:

5

quality

enum<string>

Standard:720p

Videoauflösung, Standard 720p

Optionen:

480p: geringere Schärfe, niedrigster Preis (Abrechnungsbasis)
720p: Standardschärfe, dies ist der Standardwert, Preis 2x von 480p
1080p: hohe Schärfe, Preis 4x von 480p

Verfügbare Optionen:

480p,

720p,

1080p

Beispiel:

"720p"

aspect_ratio

enum<string>

Standard:adaptive

Seitenverhältnis des Videos, Standard adaptive

Optionen:

adaptive: adaptiv, das Modell empfiehlt anhand des Verhältnisses des Eingabematerials und der Absicht des Prompts ein passendes Seitenverhältnis, dies ist der Standardwert
16:9 (Querformat), 9:16 (Hochformat), 1:1 (quadratisch), 4:3, 3:4

Verfügbare Optionen:

adaptive,

16:9,

9:16,

1:1,

4:3,

3:4

Beispiel:

"16:9"

generate_audio

boolean

Standard:true

Ob das Ausgabevideo eine Tonspur enthält, Standard true

Optionen:

true: das Ausgabevideo enthält Ton (Stimmen, Soundeffekte, Hintergrundmusik), dies ist der Standardwert
false: stummes Video

Ton an oder aus kostet gleich viel, es fallen keine Zusatzkosten an.

Beispiel:

true

seed

integer

Zufallsseed zur Reproduktion von Ergebnissen, standardmäßig zufällig

Hinweise:

Bereich: 0 ~ 2147483647
Ein fester Seed reduziert beim Iterieren am Prompt die Variation und verbessert die Reproduzierbarkeit

Erforderlicher Bereich: 0 <= x <= 2147483647

Beispiel:

42

callback_url

string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

Wird ausgelöst bei Aufgabenabschluss (completed), Fehler (failed) oder Abbruch (cancelled)
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

Videogenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1761313744

string

Aufgaben-ID

Beispiel:

"task-unified-1774857405-abc123"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"wan3.0-image-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>

Aufgaben-Ausgabetyp

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Wan3.0 Image-to-Video

Abrechnung

Autorisierungen

Body

Antwort