TokenLab

Vidéo & ressources

Lister les tâches (compatible Volc)

Liste les tâches compatibles Seedance récentes de l’organisation courante.

GET
/api/v3/contents/generations/tasks

Aperçu

Listez les tâches compatibles récentes du Workspace authentifié avec une clé API TokenLab Bearer. Sans filter.task_ids, la recherche couvre les sept derniers jours ; des ID précis permettent de consulter directement ces tâches.

Voir aussi Modèles vidéo Seedance 2.0 et Génération vidéo.

Format de réponse

  • page_num: valeur par défaut 1, entier de 1 à 500.
  • page_size: valeur 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 ID de tâche précis. Ne les séparez pas par des virgules.
  • filter.model: Identifiant du modèle.
  • filter.service_tier: default, flex.

La réponse contient items et total pour les résultats filtrés. Chaque élément suit le format de la réponse de consultation d’une tâche. Utilisez ce point de terminaison pour actualiser l’état 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 identifiant de modèle.

filter.service_tier?string

Filtrer par niveau de service.

Réponse

application/json

application/json

application/json

application/json