Seedance 1.5 Pro Asynchrone Video-Generierung

API-Dokumentation

Verwenden Sie diese Endpunkte, um Seedance 1.5 Pro Jobs einzureichen und deren Status zu überprüfen. Jeder Aufruf verbraucht Kredite basierend auf Dauer und Audio (synchronisierte Dialoge, Soundeffekte, Musik).

Authentifizierung

Alle Anfragen müssen Ihren API-Schlüssel im Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Fehlende oder ungültige Schlüssel geben 401 Unauthorized.

POST

https://seedance1-5pro.com/api/generate

Generierungsaufgabe erstellen

Reicht einen neuen Seedance 1.5 Pro Job ein. Der Aufruf gibt sofort eine task_id zurück, während das Rendern **asynchron** abgeschlossen wird.

Parameter	Typ	Erforderlich	Beschreibung
prompt	string (max 1000 chars)	Ja	Beschreibung der Hauptszene (Text oder Image-Flow).
aspect_ratio	string	Ja	Unterstützt: 16:9, 9:16, 1:1. Wird ignoriert, wenn image_urls vorhanden ist.
duration	string	Ja	Render-Länge in Sekunden ("5" oder "10").
sound	boolean	Nein	Audio in den Clip einschließen (synchronisierte Dialoge, Soundeffekte, Musik).
image_urls	string[]	Nein	Optionale URLs von Referenzbildern (erforderlich für Image-to-Video).

Kreditverbrauch

Kredite werden bei der Erstellung der Aufgabe abgezogen. Fehlgeschlagene Jobs werden automatisch **erstattet**.

Voreinstellung	Abgezogene Kredite
5 s ohne Ton	65
10 s ohne Ton	130
5 s mit Ton	130
10 s mit Ton	260

Beispielanfrage

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8"
  }
}

GET / POST

https://seedance1-5pro.com/api/status

Aufgabenstatus überprüfen

Verwenden Sie diesen Endpunkt, um den neuesten Datensatz abzufragen. Wenn sich die Aufgabe noch im Status IN_PROGRESS befindet, fragen wir den Anbieter einmal zusätzlich ab, bevor wir antworten.

Parameter	Typ	Erforderlich	Beschreibung
task_id	string	Ja	ID, zurückgegeben von /generate. Senden Sie diese über Query-Parameter (?task_id=) oder den JSON-Body.

Feld	Beschreibung
task_id	Von /generate zurückgegebene ID.
status	SUCCESS (ERFOLG)
request	Bereinigte Kopie der eingereichten Payload.
response	Array von Medien-URLs, wenn der Status SUCCESS ist.
consumed_credits	Für die Aufgabe berechnete Kredite (0 bei Rückerstattung).
error_message	Anbieterfehler, wenn der Status FAILED ist.
created_at	UTC-Zeitstempel, wann der Job gespeichert wurde.

Beispielanfrage

GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Fehlerbehandlung

401 Unauthorized - Fehlender oder ungültiger API-Schlüssel.
402 Payment Required - Das Kreditguthaben konnte die Abbuchung nicht decken.
429 Too Many Requests - Reduzieren Sie die Abfragefrequenz oder die Anfragerate.
500 - Vorübergehendes Problem; versuchen Sie es mit exponentiellem Backoff erneut.