curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-reference-video",
  "prompt": "Die Person aus dem Referenzvideo tanzt auf einer Wiese",
  "video_urls": [
    "https://example.com/reference.mp4"
  ]
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-reference-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

Wan2.7

Wan2.7 Referenzvideo

Das WAN2.7 (wan2.7-reference-video)-Modell unterstützt Referenz-zu-Video-Generierung und nutzt Personen oder Objekte als Hauptdarsteller, um Einzel- oder Mehrfigurenszenen zu erzeugen
Multimodale Eingaben: Startbild (image_start), mehrere Referenzbilder (image_urls), mehrere Referenzvideos (video_urls) sowie Stimmbindung pro Charakter
Mindestens ein Referenzbild (image_urls) oder ein Referenzvideo (video_urls) ist erforderlich; nur image_start reicht nicht. image_urls + video_urls zusammen ≤ 5
Charakter-Indexierung im Prompt: im Chinesischen “图1, 图2 / 视频1, 视频2”; im Englischen “Image 1”, “Video 1” — entsprechen 1-basiert der Reihenfolge von image_urls / video_urls. Bilder und Videos werden getrennt gezählt, daher können “Image 1” und “Video 1” nebeneinander existieren
Mehrfach-Stimmbindung: bevorzugt model_params.voice_bindings (präzise Bindung); das ältere audio_urls (positionelle Zuordnung) wird ebenfalls unterstützt
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Task-ID für die Statusabfrage
Generierte Videolinks sind 24 Stunden gültig, bitte zeitnah speichern
Abrechnung: erfolgt nach “Eingabe-Videodauer + Ausgabe-Videodauer”; nur erfolgreiche Generierungen werden abgerechnet, fehlgeschlagene Aufgaben sind kostenlos

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": "wan2.7-reference-video",
  "prompt": "Die Person aus dem Referenzvideo tanzt auf einer Wiese",
  "video_urls": [
    "https://example.com/reference.mp4"
  ]
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-reference-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

Alle APIs erfordern Bearer-Token-Authentifizierung

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüssel-Verwaltungsseite, um Ihren API-Schlüssel zu erhalten

Im Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

erforderlich

Modellname, muss wan2.7-reference-video sein

Verfügbare Optionen:

wan2.7-reference-video

Beispiel:

"wan2.7-reference-video"

prompt

string

erforderlich

Textprompt für die Videogenerierung. Unterstützt Chinesisch und Englisch; jedes Zeichen / jeder Buchstabe / jedes Satzzeichen zählt als 1, Überschuss wird automatisch gekürzt. Maximale Länge 5000 Zeichen

Charakter-Indexierungsregeln:

Chinesisch: "图1, 图2 / 视频1, 视频2" — entspricht 1-basiert der Reihenfolge von image_urls / video_urls
Englisch: "Image 1", "Video 1" (Großbuchstaben, Leerzeichen zwischen Wort und Ziffer)
Bilder und Videos werden getrennt gezählt, sodass "Image 1" und "Video 1" nebeneinander vorkommen können
Bei nur einem Referenzbild oder einem Referenzvideo kann auch "das Referenzbild" oder "das Referenzvideo" verwendet werden

Mehrfach-Raster-Bild (Storyboard): Wird ein Raster-Bild bereitgestellt, beschreiben Sie Schlüsselaufnahmen in Storyboard-Form; das Modell erkennt das Raster und füllt die Übergänge

Maximum string length: 5000

Beispiel:

"Video 1 hält Image 3 und spielt einen sanften Country-Folk auf dem Stuhl in Image 4"

negative_prompt

string

Negativprompt zur Beschreibung von Inhalten, die im Video vermieden werden sollen. Unterstützt Chinesisch und Englisch. Maximale Länge 500 Zeichen; Überschuss wird automatisch gekürzt

Maximum string length: 500

Beispiel:

"Unscharf, geringe Qualität"

image_start

string<uri>

URL des Startbilds, dient als Anfangsbild des Videos. Zählt nicht zur Obergrenze image_urls + video_urls ≤ 5. Akzeptiert keine Stimmbindung (das Startbild selbst nimmt nicht an der Mehrfach-Stimmverteilung teil)

Anwendungsfälle:

Subjekt erscheint bereits im Startbild: kombiniert mit Referenzmaterialien zur Verstärkung der Identität
Subjekt nicht im Startbild: Referenzmaterialien definieren neu auftretende Subjekte im Verlauf des Videos

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_urls

string<uri>[]

Referenzbild-URL-Liste. Kann Subjekte (Personen / Tiere / Objekte) oder Szenenhintergründe enthalten; bei Subjekten sollte jedes Bild nur einen Charakter enthalten

Mengenbegrenzung:

image_urls + video_urls zusammen ≤ 5
Mindestens eines von image_urls / video_urls muss bereitgestellt werden (nur image_start reicht nicht)

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/ref1.jpg",
  "https://example.com/ref2.jpg"
]

video_urls

string<uri>[]

Referenzvideo-URL-Liste. Sollte ein Subjekt (Person / Tier / Objekt) enthalten; leere oder reine Hintergrund-Aufnahmen werden nicht empfohlen. Bei Subjekten sollte jedes Video nur einen Charakter enthalten. Audio im Video kann als Stimmreferenz dienen

Mengenbegrenzung:

image_urls + video_urls zusammen ≤ 5
Mindestens eines von image_urls / video_urls muss bereitgestellt werden

Videogrenzen:

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

Hinweis: wenn video_urls bereitgestellt wird, ist duration auf 10 Sekunden begrenzt

Beispiel:

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

audio_urls

string<uri>[]

[Kompatibilitätsfeld — bevorzugen Sie model_params.voice_bindings]

Referenzstimme-URL-Liste. Wird positionell an Referenzmaterialien gebunden — zuerst gegen video_urls, dann gegen image_urls (in Reihenfolge der Listen, eins-zu-eins). Maximal 5 Elemente

Priorität:

Wenn sowohl model_params.voice_bindings als auch audio_urls bereitgestellt werden, wird nur voice_bindings verwendet und dieses Feld ignoriert
Wenn ein Video in video_urls Audio enthält und keine Stimmbindung gesetzt ist, wird das Original-Audio verwendet; eine explizite Stimmbindung überschreibt das Original

Audiogrenzen:

Unterstützte Formate: wav, mp3
Dauer: 1 ~ 10 Sekunden
Dateigröße: max. 15MB

Maximum array length: 5

Beispiel:

[
  "https://example.com/voice1.mp3",
  "https://example.com/voice2.mp3"
]

model_params

object

Container für erweiterte Parameter (empfohlen)

Show child attributes

quality

enum<string>

Standard:720p

Videoqualität, Standard: 720p

Optionen:

720p: Standardqualität, Standardpreis (Standard)
1080p: Hohe Qualität, höherer Preis

Verfügbare Optionen:

720p,

1080p

Beispiel:

"720p"

aspect_ratio

enum<string>

Standard:16:9

Seitenverhältnis des Videos, Standard: 16:9

Verhalten:

image_start nicht bereitgestellt: Video wird mit dem angegebenen aspect_ratio generiert
image_start bereitgestellt: dieses Feld wird ignoriert; das Video verwendet ein Seitenverhältnis ähnlich dem Startbild

Ausgabeauflösung pro Qualitätsstufe:

Qualität	16:9	9:16	1:1	4:3	3:4
720p	1280×720	720×1280	960×960	1104×832	832×1104
1080p	1920×1080	1080×1920	1440×1440	1648×1248	1248×1648

Verfügbare Optionen:

16:9,

9:16,

1:1,

4:3,

3:4

Beispiel:

"16:9"

duration

number

Standard:5

Videodauer in Sekunden (Ganzzahl)

Bereich:

Ohne video_urls: 2 ~ 15, Standard 5
Mit video_urls: 2 ~ 10 (begrenzt auf 10 Sekunden)

Abrechnung: anhand der tatsächlich generierten Videodauer

Erforderlicher Bereich: 2 <= x <= 15

Beispiel:

5

seed

integer

Zufallsseed, standardmäßig zufällig

Hinweise:

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

Erforderlicher Bereich: 1 <= x <= 2147483647

Beispiel:

42

prompt_extend

boolean

Standard:false

Ob die intelligente Prompt-Umschreibung aktiviert werden soll. Wenn aktiviert, optimiert ein großes Modell den Prompt, was die Ergebnisse für einfache oder unzureichend beschreibende Prompts deutlich verbessert.

Hinweis: Standard ist false — wird der Parameter weggelassen oder false gesendet, erfolgt keine Umschreibung. Senden Sie explizit true, um die Umschreibung zu aktivieren.

Beispiel:

true

callback_url

string<uri>

HTTPS-Callback-URL für den Aufgabenabschluss

Callback-Zeitpunkt:

Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
Wird nach Abrechnungsbestätigung gesendet

Sicherheitseinschränkungen:

Nur HTTPS wird 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 max. 2048 Zeichen

Callback-Mechanismus:

Timeout: 10 Sekunden
Bis zu 3 Wiederholungen nach Fehlschlag (jeweils nach 1/2/4 Sekunden)
Callback-Antwortformat ist identisch mit der Task-Query-API
2xx-Statuscodes gelten als erfolgreich, andere lösen Wiederholungen aus

Beispiel:

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

Antwort

Video-Aufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757169743

string

Aufgaben-ID

Beispiel:

"task-unified-1757169743-7cvnl5zw"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"wan2.7-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 Video-Aufgabe

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

Wan2.7 Bild-zu-Video Wan2.7 Videobearbeitung