Zum Hauptinhalt springen
POST
/
v1
/
videos
/
generations
seedance-2.0 API
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0",
  "prompt": "@Image1 as first frame, a cinematic drone shot over a coastal city at golden hour",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "audio_urls": [
    "https://example.com/reference.mp3"
  ],
  "duration": 10,
  "quality": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'
{
  "created": 1761313744,
  "id": "task-unified-1761313744-vux2jw0k",
  "model": "seedance-2.0",
  "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"
  }
}
Dieses Modell ist noch nicht verfügbar. Die API-Parameter können vor der offiziellen Veröffentlichung angepasst werden. Bitte beziehen Sie sich auf das tatsächliche Verhalten nach dem Start.

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-2.0
erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:
seedance-2.0
Beispiel:

"seedance-2.0"

​
prompt
string
erforderlich

Prompt, der das zu generierende Video beschreibt, begrenzt auf 2000 Token. Verwenden Sie @-Referenz-Tags, um hochgeladenen Dateien Rollen zuzuweisen

@-Referenz-Tags:

  • @Image1, @Image2... → Bilder aus image_urls (in Reihenfolge)
  • @Video1, @Video2... → Videos aus video_urls (in Reihenfolge)
  • @Audio1, @Audio2... → Audios aus audio_urls (in Reihenfolge)
  • Beispiel: @Image1 as first frame, replicate @Video1 camera movement, @Audio1 for BGM rhythm
Maximum string length: 2000
Beispiel:

"@Image1 as first frame, a cinematic drone shot over a coastal city at golden hour"

​
image_urls
string<uri>[]

Referenzbild-URL-Liste für Bild-zu-Video und multimodale Generierung

Hinweis:

  • Maximal 9 Bilder pro Anfrage
  • Maximale Größe: 30MB pro Bild
  • Unterstützte Dateiformate: .jpeg, .png, .webp, .bmp, .tiff, .gif
  • Gemischte Eingabe-Gesamtlimit: 12 Dateien über alle Modalitäten
  • Uploads von realistischen menschlichen Gesichtern werden nicht unterstützt und automatisch abgelehnt
  • Bild-URLs müssen vom Server direkt zugänglich sein
Maximum array length: 9
Beispiel:
["https://example.com/image.jpg"]
​
video_urls
string<uri>[]

Referenzvideo-URL-Liste für Video-zu-Video-Bearbeitung und @-Referenzsystem

Hinweis:

  • Maximal 3 Videos pro Anfrage, Gesamtdauer 2–15 Sekunden
  • Maximale Größe: 50MB pro Video
  • Unterstützte Dateiformate: .mp4, .mov
  • Pixelbereich: 409.600 (480p) – 927.408 (720p)
  • Die Verwendung von Videoreferenzen erhöht die Kosten
  • Uploads von realistischen menschlichen Gesichtern werden nicht unterstützt und automatisch abgelehnt
  • URLs müssen vom Server direkt zugänglich sein
Maximum array length: 3
Beispiel:
["https://example.com/reference.mp4"]
​
audio_urls
string<uri>[]

Referenzaudio-URL-Liste für audiogesteuerte Generierung über das @-Referenzsystem

Hinweis:

  • Maximal 3 Audiospuren pro Anfrage, Gesamtdauer ≤ 15 Sekunden
  • Maximale Größe: 15MB pro Audio
  • Unterstützte Dateiformate: .mp3, .wav
  • Richtet Schnitte, Bewegungsenergie und Übergänge an Beat und Rhythmus aus
  • URLs müssen vom Server direkt zugänglich sein
Maximum array length: 3
Beispiel:
["https://example.com/reference.mp3"]
​
duration
integer

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

Hinweis:

  • Unterstützt jeden ganzzahligen Wert zwischen 4 und 15 Sekunden
  • Die Abrechnung einer einzelnen Anfrage basiert auf dem duration-Wert; längere Dauern führen zu höheren Kosten
Erforderlicher Bereich: 4 <= x <= 15
​
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 2.0 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-2.0"

​
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