curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-text-to-video",
  "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-text-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-text-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 Vollständige Parameterreferenz

Einheitliche API für Wan 3.0 (Allround-Referenzvideo), der Modus wird über den Parameter model gewählt

3 Generierungsmodi:

Text-to-Video (wan3.0-text-to-video): Video allein aus einem Text-Prompt
Image-to-Video (wan3.0-image-to-video): Startbild / Start- und Endbild steuern streng Anfang und Ende des Bildes
Reference-to-Video (wan3.0-reference-video): gemischte multimodale Referenzen — Referenzbilder + Referenzvideos + Referenzaudio + Dateien / Webseiten

Gemeinsame Funktionen:

Videos von bis zu 30 Sekunden
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-text-to-video",
  "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-text-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-text-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>

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

wan3.0-text-to-video,

wan3.0-image-to-video,

wan3.0-reference-video

Beispiel:

"wan3.0-text-to-video"

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)

Pflichtangabe: für wan3.0-text-to-video erforderlich; für wan3.0-reference-video mindestens eines von Prompt und Referenzmaterial; für wan3.0-image-to-video empfohlen, um die Bildveränderung zu beschreiben

Regeln für Materialverweise (Reference-to-Video):

Mit "Image 1", "Video 1" und "Audio 1" wird auf das Material im jeweiligen Array verwiesen (1-basiert)
Bilder, Videos und Audio werden unabhängig voneinander gezählt, "Image 1" und "Video 1" können also gleichzeitig vorkommen

Beispiel:

"The character in Video 1 holds Image 3 and plays a soft country folk tune on the chair in Image 4, saying: “What lovely sunshine today.”"

image_start

string<uri>

URL des Startbilds, wird streng als erstes Bild des generierten Videos verwendet. Nur für wan3.0-image-to-video verfügbar

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"

image_end

string<uri>

URL des Endbilds, wird streng als letztes Bild des generierten Videos verwendet. Nur für wan3.0-image-to-video verfügbar

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"

image_urls

string<uri>[]

Array mit URLs von Referenzbildern, höchstens 10 Bilder, nur für wan3.0-reference-video verfügbar. Es kann Subjekte (Personen/Tiere/Objekte) oder Szenenhintergründe liefern; bei Subjekten sollte jedes Bild nur einen Charakter enthalten

Die Reihenfolge im Array entspricht "Bild 1, Bild 2 ..." im Prompt

Hinweis: Für Start- und Endbild von Image-to-Video image_start / image_end verwenden, nicht dieses Feld

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

Maximum array length: 10

Beispiel:

[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.png"
]

video_urls

string<uri>[]

Array mit URLs von Referenzvideos, höchstens 5 Clips, nur für wan3.0-reference-video verfügbar. Die Reihenfolge im Array entspricht "Video 1, Video 2 ..." im Prompt

Dauerbegrenzung:

1 ~ 15 Sekunden pro Clip
insgesamt höchstens 15 Sekunden
Gesamtdauer der Referenzvideos + Dauer des Ausgabevideos darf 30 Sekunden nicht überschreiten

🔴 Referenzvideos zählen zur Abrechnung: abgerechnete Dauer = Dauer des Eingabevideos + Dauer des Ausgabevideos. Referenzbilder, Referenzaudio, Dateien und Webseiten werden nicht abgerechnet

Videogrenzen:

Formate: mp4, mov
Auflösung: Breite und Höhe in [240, 4096] Pixel
Seitenverhältnis: 1:8 ~ 8:1
Größe pro Datei: max. 100MB

Maximum array length: 5

Beispiel:

["https://example.com/ref_video.mp4"]

audio_urls

string<uri>[]

Array mit URLs von Referenzaudio, höchstens 5 Clips, nur für wan3.0-reference-video verfügbar. Die Reihenfolge im Array entspricht "Audio 1, Audio 2 ..." im Prompt

⚠️ Andere Semantik als in Wan2.7: In Wan2.7 war audio_urls eine Stimme, die an ein bestimmtes Referenzbild / Referenzvideo gebunden war; in Wan3.0 ist Referenzaudio eigenständiges Material, das im Prompt direkt mit "Audio 1" angesprochen wird, und das Stimmbindungs-Protokoll model_params.voice_bindings wird nicht unterstützt. Beim Umstieg von Wan2.7 bitte entsprechend anpassen.

Dauerbegrenzung:

1 ~ 15 Sekunden pro Clip, insgesamt höchstens 15 Sekunden
Referenzaudio wird nicht abgerechnet

Audiogrenzen:

Formate: wav, mp3
Dateigröße: max. 15MB

Maximum array length: 5

Beispiel:

["https://example.com/ref_audio.mp3"]

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.

Zusätzliche Einschränkung bei übergebenen Referenzvideos:

Gesamtdauer der Referenzvideos + Dauer des Ausgabevideos darf 30 Sekunden nicht überschreiten
Beispiel: bei insgesamt 10 Sekunden Referenzvideo kann duration höchstens 20 betragen

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

model_params

object

Modellerweiterungsparameter, nur für wan3.0-reference-video verfügbar. file_url und link_url schließen sich gegenseitig aus, es ist nur eines von beiden möglich

Show child attributes

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-text-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 Vollständige Parameterreferenz

Abrechnung

Autorisierungen

Body

Antwort