FocalAPI Docs
API 参考视频创作

列出当前 Key 用户的近期任务

GET
/v1/tasks

分页返回当前用户的任务(最新在前),用于提交输出丢失后对账找回 task_id。status 用外部词表 queued/in_progress/completed/failed/cancelled 过滤;action 可选(如 generate、image_generation)。不含 prompt 等请求内容。

Authorization

BearerAuth
AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Query Parameters

limit?integer

每页数量,默认 20,上限 100

Range1 <= value <= 100
Default20
offset?integer

偏移量

Range0 <= value
Default0
status?string

按外部状态过滤

Value in

  • "queued"
  • "in_progress"
  • "completed"
  • "failed"
  • "cancelled"
action?string

按任务类型过滤

Response Body

application/json

curl -X GET "https://example.com/v1/tasks"
{  "object": "list",  "data": [    {      "task_id": "string",      "model": "string",      "action": "string",      "status": "in_progress",      "progress": 0,      "quota": 0,      "created_at": 0,      "updated_at": 0    }  ]}