Vidéo & ressources
Obtenir une tâche (compatible Volc)
Obtenir une tâche de compatibilité Seedance par son ID de tâche cgt.
Aperçu
Utilisez l'ID cgt-... renvoyé par la création. Interrogez l'API toutes les quelques secondes tant que la tâche est à l'état queued ou running. Arrêtez-vous lorsque la tâche est à l'état succeeded, failed, cancelled ou expired.
N'utilisez pas ici l'enum de tâche ou la structure de réponse unifiée v1. /v1/tasks/{id} utilise pending, processing, completed et failed ; ce endpoint v3 utilise l'enum officiel ci-dessus. Dans l'objet JSON v3, duration est une chaîne de caractères lorsqu'elle est présente et error est optionnel et contient les détails de l'erreur lorsqu'ils sont disponibles. Un client Go strict doit déclarer Duration en tant que string avec le tag JSON duration,omitempty, et s'arrêter sur chaque statut terminal v3.
Voir aussi Modèles vidéo Seedance 2.0 et Génération de vidéo.
Valeurs de statut
queued: acceptée et en attente d'exécution.running: la génération est en cours.succeeded: le résultat est prêt etcontent.video_urlest présent.failed: la génération a échoué ; inspectezerror.codeeterror.message.cancelled: la tâche a été annulée avant son achèvement.expired: la tâche a expiré avant son achèvement.
Champs de réponse
id: ID de la tâche de compatibilité, commençant parcgt-.model: la valeurmodelque vous avez envoyée lors de la création de la tâche.status: l'une des valeurs de statut ci-dessus.content.video_url: URL finale de la vidéo en cas de succès. Il s'agit d'un lien de résultat TokenLab qui reste valide pendant 30 jours ; voir Rétention des données.content.last_frame_url: présent uniquement lorsqu'il est demandé et disponible.usage:completion_tokensettotal_tokenslorsqu'ils sont disponibles, ainsi quetool_usage.web_searchlorsque l'outil de recherche web a été exécuté.created_atetupdated_at: horodatages Unix en secondes.error:{ code, message }lorsque les détails de l'erreur sont disponibles. Ne déduisez pas sa présence uniquement à partir destatus.- Les valeurs de requête définies pour la tâche sont renvoyées lorsqu'elles sont disponibles :
seed,resolution,ratio,duration(chaîne),generate_audio,service_tier,execution_expires_after,safety_identifier,tools,draft,draft_task_id,framesetframespersecond.
La réponse n'ajoute jamais de champs TokenLab tels que progress, return_last_frame, watermark, priority ou camera_fixed.
Un ID de tâche inconnu ou expiré renvoie 404 ; un ID appartenant à une autre organisation renvoie 403.
Exemple
curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
-H "Authorization: Bearer $TOKENLAB_API_KEY"{
"id": "cgt-20260102030405-a1b2c",
"model": "seedance-2.0",
"status": "succeeded",
"content": {
"video_url": "https://api.tokenlab.sh/v1/media-results/3f2b8c1e-6d4a-4e9b-8a7c-2d5e1f0b9c4a.mp4?token=…"
},
"usage": {
"completion_tokens": 123456
}
}type SeedanceTask struct {
ID string `json:"id"`
Status string `json:"status"`
Duration string `json:"duration,omitempty"`
}
func isTerminal(status string) bool {
switch status {
case "succeeded", "failed", "cancelled", "expired":
return true
default:
return false
}
}curl -X GET "https://example.com/api/v3/contents/generations/tasks/string"{ "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de chemin
ID de tâche de compatibilité renvoyé par le point de terminaison de création. Les IDs commencent par cgt-.
Réponse
application/json
application/json
application/json
application/json
application/json
application/json