Video y recursos
Listar tareas (Compatible con Volc)
Listar tareas recientes de compatibilidad con Seedance para la organización actual.
Descripción general
Enumera las tareas de compatibilidad de la organización autenticada utilizando una clave API Bearer de TokenLab. Solo se enumeran las tareas creadas a través del endpoint de creación compatible con Volc. Sin filter.task_ids, los resultados cubren las tareas de los últimos siete días; proporcionar IDs exactos consulta esas tareas directamente.
Consulte también Modelos de video Seedance 2.0 y Generación de video.
Listado y filtros
page_num: predeterminado1, entero de1a500.page_size: predeterminado20, entero de1a500.filter.status:queued,running,succeeded,failed,cancelled,expired.filter.task_ids: Repita este parámetro para múltiples IDs de tarea exactos; no los una con comas.filter.model: El valormodelenviado cuando se creó la tarea.filter.service_tier:default,flex.
La respuesta contiene items (la página solicitada) y total (todas las tareas que coinciden con los filtros). Cada elemento utiliza la estructura de respuesta de get-task. Un parámetro no admitido o un valor fuera de rango devuelve 400. Utilice el endpoint get para actualizar el estado de una tarea conocida.
Ejemplo
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}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de consulta
Número de página.
1 <= value <= 5001Tamaño de página.
1 <= value <= 50020Filtrar por estado de tarea.
Valores permitidos
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
IDs de tarea exactos. Repita filter.task_ids para múltiples IDs.
Filtrar por el valor del modelo enviado cuando se creó la tarea.
Filtrar por nivel de servicio.
Valores permitidos
- "default"
- "flex"
Respuesta
application/json
application/json
application/json
application/json