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 Text-to-Video

Erzeugt das Video allein aus prompt, es werden keinerlei Medien als Eingabe akzeptiert
Videos von bis zu 30 Sekunden, duration: -1 (intelligente Dauer) wird unterstützt
Für die Steuerung von Start-/Endbild verwenden Sie Wan3.0 Image-to-Video; für Referenzmaterial Wan3.0 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-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>

Standard:wan3.0-text-to-video

erforderlich

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

Verfügbare Optionen:

wan3.0-text-to-video

Beispiel:

"wan3.0-text-to-video"

prompt

string

erforderlich

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)

Hinweis: Dieses Modell ist reines Text-to-Video und akzeptiert keinerlei Medien als Eingabe.

Beispiel:

"A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work."

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-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 Text-to-Video

Abrechnung

Autorisierungen

Body

Antwort