TokenLab

Vidéo & ressources

Obtenir une tâche (compatible Volc)

Obtenir une tâche de compatibilité Seedance par son ID de tâche cgt.

GET
/api/v3/contents/generations/tasks/{id}

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 et content.video_url est présent.
  • failed : la génération a échoué ; inspectez error.code et error.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 par cgt-.
  • model : la valeur model que 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_tokens et total_tokens lorsqu'ils sont disponibles, ainsi que tool_usage.web_search lorsque l'outil de recherche web a été exécuté.
  • created_at et updated_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 de status.
  • 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, frames et framespersecond.

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
  }
}
Go
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
AuthorizationBearer <token>

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*string

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