TokenLab

Vidéo & ressources

Lister les tâches (Compatible Volc)

Lister les tâches de compatibilité Seedance récentes pour l'organisation actuelle.

GET
/api/v3/contents/generations/tasks

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éfaut 1, entier de 1 à 500.
  • page_size : par défaut 20, entier de 1 à 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 valeur model envoyé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
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 requête

page_num?integer

Numéro de page.

Plage1 <= value <= 500
par défaut1
page_size?integer

Taille de la page.

Plage1 <= value <= 500
par défaut20
filter.status?string

Filtrer par statut de tâche.

Valeurs possibles

  • "queued"
  • "running"
  • "succeeded"
  • "failed"
  • "cancelled"
  • "expired"
filter.task_ids?array<string>

IDs de tâche exacts. Répétez filter.task_ids pour plusieurs IDs.

filter.model?string

Filtrer par la valeur du modèle envoyée lors de la création de la tâche.

filter.service_tier?string

Filtrer par niveau de service.

Valeurs possibles

  • "default"
  • "flex"

Réponse

application/json

application/json

application/json

application/json