Seedance 2.0 — Récupérer une vidéo (format de la plateforme)

Consultez une tâche vidéo Seedance 2.0 via l’interface Video Generations de la plateforme.

Utilisez l’ID de tâche pour consulter son état et son résultat. Par défaut, l’objet de tâche de la plateforme est renvoyé ; raw=true renvoie directement la structure native Volcengine Ark, show_raw=true inclut cette même structure dans l’enveloppe de la plateforme et show_usage=true renvoie les informations d’utilisation mises en forme par la plateforme. Les URL de la vidéo et de l’image finale peuvent expirer ; téléchargez-les ou sauvegardez-les rapidement ailleurs.

Pour obtenir directement la structure de tâche Volcengine Ark, consultez l’interface de consultation au format natif.

Les données de tâche natives prennent en charge la résolution 4k de Seedance 2.0 standard et la priority de la tâche ; Fast est limité à 480p/720p.

GET/v1/video/generations/{task_id}

Utilisez l’ID de tâche renvoyé par l’interface de création pour consulter une tâche vidéo Seedance 2.0. Arrêtez les consultations régulières une fois la tâche completed ou failed.

Un intervalle de 30 à 60 secondes est recommandé. L’URL de la vidéo terminée peut expirer ; téléchargez-la et sauvegardez-la rapidement ailleurs.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Paramètres de chemin

task_id*string

ID de tâche renvoyé lors de la création de la tâche vidéo.

Longueur1 <= length

Paramètres de requête URL

raw?boolean

Avec true, renvoie directement les données brutes de la tâche provenant du service en amont, pour faciliter le dépannage.

show_raw?boolean

Avec true, inclut les données brutes de la tâche provenant du service en amont dans le champ data.data de la réponse compatible enveloppée.

show_usage?boolean

Avec true, inclut les informations d’utilisation dans le champ data.usage de la réponse compatible enveloppée si la tâche a réussi.

Corps de réponse

`application/json`

curl -X GET "https://example.com/v1/video/generations/cgt-20260330164007-wnc8k"

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Référence de la structure native des tâches Seedance 2.0Consultez la structure de consultation des tâches Volcengine Ark utilisée par raw et show_raw.

Seedance 2.0 — Récupérer une vidéo (format de la plateforme)

Authentification

Paramètres de chemin

Paramètres de requête URL

Corps de réponse

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`