Interrogez une tâche vidéo Seedance par id sur CometAPI avec GET /v1/videos/. Fonctionne pour les tâches Seedance 1.0 Pro, 1.5 Pro et 2.0. Renvoie le statut actuel, la progression et le video_url signé une fois que la tâche atteint SUCCESS.
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
-H "Authorization: Bearer <COMETAPI_KEY>"{
"id": "task_abc123",
"model": "doubao-seedance-2-0-fast",
"object": "video",
"status": "IN_PROGRESS",
"progress": 45,
"created_at": 1776567610,
"completed_at": null
}id dans le chemin est la valeur renvoyée par l’appel de création, quel que soit le modèle Seedance qui a produit la tâche.
SUBMITTED et IN_PROGRESS ne sont pas terminaux ; SUCCESS, FAILED et ERROR sont terminaux et la tâche n’évoluera plus.
| Status | Signification | Terminal |
|---|---|---|
SUBMITTED | Acceptée et mise en file d’attente pour le rendu. | non |
IN_PROGRESS | Rendu en cours. | non |
SUCCESS | Terminée. video_url est présent dans la réponse. | oui |
FAILED | Le fournisseur a rejeté la tâche. | oui |
ERROR | Une erreur interne a empêché l’achèvement. | oui |
import time
import requests
TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"SUCCESS", "FAILED", "ERROR"}
while True:
response = requests.get(
f"https://api.cometapi.com/v1/videos/{TASK_ID}",
headers=headers,
timeout=15,
)
response.raise_for_status()
data = response.json()
if data["status"] in TERMINAL:
print(data.get("video_url"))
break
time.sleep(10)
status — détermine la condition d’arrêt de votre boucle d’interrogation.progress — entier de 0 à 100 que vous pouvez afficher dans une UI.video_url — URL de téléchargement signée, présente uniquement en cas de SUCCESS. La signature a une durée de validité limitée ; téléchargez ou réhébergez le fichier avant l’expiration de la signature.completed_at — horodatage Unix renseigné une fois que la tâche atteint un statut terminal.model — reprend l’id du modèle Seedance utilisé lors de la création de la tâche.400 avec message: "task_not_exist" signifie que le id est inconnu. Vérifiez que vous avez bien récupéré le id à partir d’une réponse POST /v1/videos réussie et que vous l’utilisez tel quel.401 signifie que le bearer token est manquant ou invalide. Vérifiez que l’en-tête de requête est Authorization: Bearer <COMETAPI_KEY>.Bearer token authentication. Use your CometAPI key.
Task id returned by POST /v1/videos.
Current task state.
Task id.
Object type, always video.
Model id that generated the task.
Task status. SUBMITTED and IN_PROGRESS are non-terminal. SUCCESS, FAILED, and ERROR are terminal.
SUBMITTED, IN_PROGRESS, SUCCESS, FAILED, ERROR Completion percentage.
0 <= x <= 100Task creation time as a Unix timestamp in seconds.
Signed download URL for the finished video. Present only when status is SUCCESS. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.
Task completion time as a Unix timestamp in seconds. null while the task is non-terminal.
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
-H "Authorization: Bearer <COMETAPI_KEY>"{
"id": "task_abc123",
"model": "doubao-seedance-2-0-fast",
"object": "video",
"status": "IN_PROGRESS",
"progress": 45,
"created_at": 1776567610,
"completed_at": null
}