Zum Hauptinhalt springen
POST
/
v1
/
videos
/
generations
seedance-1.5-pro API
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-1.5-pro",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1761313744,
  "id": "task-unified-1761313744-vux2jw0k",
  "model": "seedance-1.5-pro",
  "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_call",
    "credits_reserved": 8,
    "user_group": "default"
  }
}

Autorisierungen

​
Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

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

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
Standard:seedance-1.5-pro
erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:
seedance-1.5-pro
Beispiel:

"seedance-1.5-pro"

​
prompt
string
erforderlich

Prompt, der das zu generierende Video beschreibt, begrenzt auf 2000 Token

Maximum string length: 2000
Beispiel:

"A cat playing piano"

​
image_urls
string<uri>[]

Referenzbild-URL-Liste für die Bild-zu-Video-Funktionalität

Moduserkennung:

  • 0 Bilder = Text-zu-Video
  • 1 Bild = Bild-zu-Video
  • 2 Bilder = Erst-Letzt-Bild

Hinweis:

  • Anzahl der unterstützten Bilder pro Anfrage: 2 Bilder
  • Bildgröße: Nicht mehr als 10MB
  • Unterstützte Dateiformate: .jpg, .jpeg, .png, .webp
  • Bild-URLs müssen vom Server direkt aufrufbar sein, oder die URL sollte beim Zugriff einen direkten Download auslösen (typischerweise enden diese URLs mit Bilderweiterungen wie .png, .jpg)
Maximum array length: 2
Beispiel:
["https://example.com/image.jpg"]
​
duration
integer

Gibt die Dauer des generierten Videos an (in Sekunden), Standardwert ist 5 Sekunden

Hinweis:

  • Unterstützt jeden ganzzahligen Wert zwischen 4 und 12 Sekunden
  • Die Abrechnung einer einzelnen Anfrage basiert auf dem duration-Wert; längere Dauern führen zu höheren Kosten
Erforderlicher Bereich: 4 <= x <= 12
​
quality
enum<string>

Videoauflösung, Standardwert ist 720p

Hinweis:

  • 480p: Niedrigere Auflösung, günstigerer Preis
  • 720p: Standardauflösung, Standardpreis, dies ist der Standardwert
  • 1080p: Hohe Auflösung, höherer Preis
Verfügbare Optionen:
480p,
720p,
1080p
Beispiel:

"720p"

​
aspect_ratio
string

Video-Seitenverhältnis

Unterstützte Werte:

  • 16:9 (Querformat), 9:16 (Hochformat), 1:1 (Quadrat), 4:3, 3:4, 21:9 (Ultrabreit), adaptive
  • Standardwert: 16:9
Beispiel:

"16:9"

​
generate_audio
boolean
Standard:true

Ob Audio generiert werden soll, die Aktivierung erhöht die Kosten, Standardwert ist true

Optionen:

  • true: Die Modellausgabe enthält synchronisiertes Audio. Seedance 1.5 Pro kann automatisch passende Stimme, Soundeffekte und Hintergrundmusik basierend auf Textprompts und visuellem Inhalt generieren. Es wird empfohlen, Dialoge in doppelte Anführungszeichen zu setzen, um die Audiogenerierung zu optimieren. Beispiel: Der Mann hielt die Frau an und sagte: "Denk daran, du darfst niemals mit dem Finger auf den Mond zeigen."
  • false: Die Modellausgabe ist stumm
Beispiel:

true

​
callback_url
string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkt:

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

Sicherheitsbeschränkungen:

  • Nur HTTPS-Protokoll wird unterstützt
  • Callbacks an interne Netzwerk-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 darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Maximal 3 Wiederholungsversuche nach Fehlschlag (Wiederholungen erfolgen nach 1/2/4 Sekunden nach dem Fehlschlag)
  • Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
  • Callback-URL, die einen 2xx-Statuscode zurückgibt, gilt als erfolgreich; 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

​
id
string

Aufgaben-ID

Beispiel:

"task-unified-1761313744-vux2jw0k"

​
model
string

Tatsächlich verwendeter Modellname

Beispiel:

"seedance-1.5-pro"

​
object
enum<string>

Spezifischer Typ der Aufgabe

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

​
type
enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"video"

​
usage
object

Nutzungs- und Abrechnungsinformationen