curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-reference-video",
  "prompt": "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_urls": [
    "https://example.com/role.jpg",
    "https://example.com/object.png",
    "https://example.com/guitar.png",
    "https://example.com/chair.png"
  ],
  "video_urls": [
    "https://example.com/ref_role.mp4"
  ],
  "duration": 10,
  "quality": "720p",
  "aspect_ratio": "adaptive"
}
'

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

Referenzbilder / Referenzvideos / Referenzaudio / Dateien / Webseiten dienen als Material; das Modell versteht die Absicht automatisch und generiert daraus das Video
Im Prompt wird das Material mit “Image 1”, “Video 1” und “Audio 1” angesprochen, die drei Materialarten werden unabhängig voneinander gezählt
Von prompt und Referenzmaterial muss mindestens eines angegeben werden
Start-/Endbild werden nicht akzeptiert (image_start / image_end): Referenzmaterial und Start-/Endbild schließen sich gegenseitig aus. Um Anfang und Ende des Bildes streng zu steuern, verwenden Sie Wan3.0 Image-to-Video
🔴 Referenzvideos zählen zur Abrechnung, Referenzbilder / Referenzaudio / Dateien / Webseiten werden nicht abgerechnet
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-reference-video",
  "prompt": "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_urls": [
    "https://example.com/role.jpg",
    "https://example.com/object.png",
    "https://example.com/guitar.png",
    "https://example.com/chair.png"
  ],
  "video_urls": [
    "https://example.com/ref_role.mp4"
  ],
  "duration": 10,
  "quality": "720p",
  "aspect_ratio": "adaptive"
}
'

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

erforderlich

Modellname, fest auf wan3.0-reference-video

Verfügbare Optionen:

wan3.0-reference-video

Beispiel:

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

Regeln für Materialverweise:

Mit "Image 1", "Image 2" wird auf die Bilder an der entsprechenden Position in image_urls verwiesen (1-basiert)
Mit "Video 1", "Video 2" wird auf die Videos an der entsprechenden Position in video_urls verwiesen
Mit "Audio 1", "Audio 2" wird auf die Audiodateien an der entsprechenden Position in audio_urls verwiesen
Bilder, Videos und Audio werden unabhängig voneinander gezählt, "Image 1" und "Video 1" können also gleichzeitig vorkommen
In englischen Prompts "Image 1", "Video 1", "Audio 1" schreiben (groß geschrieben, mit Leerzeichen zwischen Wort und Zahl)

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_urls

string<uri>[]

Array mit URLs von Referenzbildern, höchstens 10 Bilder. 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.

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. 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. 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"]

model_params

object

Modellerweiterungsparameter. file_url und link_url schließen sich gegenseitig aus, es ist nur eines von beiden möglich

Show child attributes

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

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-reference-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 Reference-to-Video

Abrechnung

Autorisierungen

Body

Antwort