Zum Hauptinhalt springen
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
Verwenden Sie diesen Endpunkt, um einen ByteDance Seedance-Video-Task aus Text oder aus Text plus Referenzbildern zu starten. Die Anfrage gibt sofort eine Task-ID zurück, und das Rendering läuft asynchron weiter.

​
Aktuellen Modellpfad wählen

  • Verwenden Sie die Seite Models für die aktuelle Modellverfügbarkeit und Bezeichner.
  • Verwenden Sie doubao-seedance-1-5-pro-251215 als aktuelles Produktionsbeispiel für diese Route.
  • Dasselbe aktuelle Modell kann sowohl reine Textanfragen als auch bildgestützte Anfragen über das einheitliche content-Array verarbeiten.

​
Task-Ablauf

1

Das content-Array erstellen

Stellen Sie die Haupt-Textanweisung an den Anfang und fügen Sie Bildelemente nur dann hinzu, wenn Sie eine Steuerung über das erste oder letzte Frame benötigen.
2

Den Task absenden

Speichern Sie die zurückgegebene Task-ID. Wenn Sie Push-Zustellung möchten, setzen Sie callback_url, wenn Sie den Task erstellen.
3

Pollen, bis die Ausgabe eintrifft

Rufen Sie ByteDance Video Query auf, bis der Task abgeschlossen ist und ein content.video_url vorhanden ist.

​
Bekanntes Wrapper-Verhalten

Volcengine und Seedance dokumentieren diese Produktfamilie als asynchronen Create-then-query-Workflow. CometAPI behält dasselbe Task-Muster bei, bietet Ihnen aber eine einzige Basis-URL und einen einzigen API-Schlüssel.
Während der Live-Validierung am 2026-03-12 war diese Route erreichbar, gab jedoch weiterhin einen serverseitigen JSON-Parse-Fehler für ein standardmäßiges JSON-Beispiel zurück. Betrachten Sie die OpenAPI-Beispiele hier als praktische Wrapper-Referenz und validieren Sie Ihre Payload frühzeitig in der Entwicklung.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
model
string
erforderlich

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

Beispiel:

"doubao-seedance-1-5-pro-251215"

​
content
object[]
erforderlich

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

​
callback_url
string

Optional webhook URL for task status notifications.

Antwort

200 - application/json

Task accepted.

​
id
string
erforderlich

Task id for later polling.