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

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

Utilisez l’ID de tâche pour consulter son état et son résultat. La réponse par défaut est une enveloppe compatible de la plateforme composée de code, message et data ; raw=true renvoie directement la structure native Volcengine Ark, show_raw=true inclut cette même structure dans data.data et show_usage=true inclut les informations d’utilisation mises en forme par la plateforme dans data.usage. L’URL vidéo peut expirer ; sauvegardez la vidéo rapidement ailleurs.

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

Lors de la consultation des brouillons Draft et des vidéos finales, les champs draft et draft_task_id des données natives permettent de distinguer les tâches. Consultez le guide des vidéos Draft pour le processus complet.

GET/v1/video/generations/{task_id}

Utilisez l’ID renvoyé par l’interface de création pour consulter une tâche vidéo Seedance 2.5. Par défaut, la réponse est une enveloppe compatible de la plateforme composée de code, message et data ; arrêtez les consultations régulières une fois la tâche succeeded, completed ou failed.

Avec raw=true, vous pouvez lire directement la structure native de tâche Volcengine Ark ; show_raw=true inclut cette même structure dans data.data de l’enveloppe compatible ; show_usage=true inclut les informations d’utilisation mises en forme par la plateforme dans data.usage si la tâche a réussi.

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 d’une tâche Seedance 2.5.

Longueur1 <= length

Paramètres de requête URL

raw?boolean

Avec true, renvoie directement les données brutes enregistrées de la tâche provenant du service en amont.

show_raw?boolean

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

show_usage?boolean

Avec true, inclut les informations d’utilisation dans 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/task_xxxxx"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "succeeded",
    "url": "https://example.com/generated-video.mov",
    "format": "mov",
    "metadata": null,
    "error": null
  }
}

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

Seedance 2.5 — 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

404

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`