Vidéo & ressources
Lister les tâches (Compatible Volc)
Lister les tâches de compatibilité Seedance récentes pour l'organisation actuelle.
Aperçu
Listez les tâches de compatibilité de l'organisation authentifiée en utilisant une clé API Bearer TokenLab. Seules les tâches créées via le point de terminaison de création compatible Volc sont listées. Sans filter.task_ids, les résultats couvrent les tâches des sept derniers jours ; fournir des identifiants exacts permet d'interroger directement ces tâches.
Voir aussi Modèles vidéo Seedance 2.0 et Génération de vidéo.
Liste et filtres
page_num: par défaut1, entier de1à500.page_size: par défaut20, entier de1à500.filter.status:queued,running,succeeded,failed,cancelled,expired.filter.task_ids: Répétez ce paramètre pour plusieurs identifiants de tâche exacts ; ne les séparez pas par des virgules.filter.model: La valeurmodelenvoyée lors de la création de la tâche.filter.service_tier:default,flex.
La réponse contient items (la page demandée) et total (toutes les tâches correspondant aux filtres). Chaque élément utilise la structure de réponse get-task. Un paramètre non pris en charge ou une valeur hors plage renvoie 400. Utilisez le point de terminaison get pour actualiser le statut d'une tâche connue.
Exemple
curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?filter.task_ids=cgt-20260102030405-a1b2c" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl -X GET "https://example.com/api/v3/contents/generations/tasks"{ "items": [ { "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 } ], "total": 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 requête
Numéro de page.
1 <= value <= 5001Taille de la page.
1 <= value <= 50020Filtrer par statut de tâche.
Valeurs possibles
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
IDs de tâche exacts. Répétez filter.task_ids pour plusieurs IDs.
Filtrer par la valeur du modèle envoyée lors de la création de la tâche.
Filtrer par niveau de service.
Valeurs possibles
- "default"
- "flex"
Réponse
application/json
application/json
application/json
application/json