genkiln

任务列表

GET /v1/tasks：按时间倒序分页获取任务，支持游标分页及按模型、状态筛选。

HTTP
GET https://genkiln.com/v1/tasks

按创建时间倒序返回你的任务，包括你在网站 Playground 中发起的任务。

查询参数

参数类型说明
limitinteger每页数量，1–100，默认 20；超过 100 按 100 处理。
cursorstring上一页返回的 next_cursor。第一页不传。
modelstring只返回该模型的任务。
statusstring只返回该状态的任务：queued、processing、succeeded、failed 或 canceled。

status 无效或 cursor 格式错误时返回 400 invalid_request。

响应

JSON
{
  "object": "list",
  "data": [
    {
      "id": "task_01JC8ZQ0E6H2P4N7K9T3W5Y8VA",
      "object": "task",
      "model": "veo-3.1-fast",
      "status": "succeeded",
      "...": "..."
    }
  ],
  "has_more": true,
  "next_cursor": "MTc5MzY2OTUxOTAwMDp0YXNrXzAxSkM4WlEwRTZIMlA0TjdLOVQzVzVZOFZB"
}

data 中每一项都是完整的任务对象。has_more 为 false 时 next_cursor 为 null。请把游标当作不透明字符串使用。

遍历所有页

curl "https://genkiln.com/v1/tasks?limit=50&status=succeeded" \
  -H "Authorization: Bearer $GENKILN_API_KEY"

# next page
curl "https://genkiln.com/v1/tasks?limit=50&status=succeeded&cursor=MTc5MzY2..." \
  -H "Authorization: Bearer $GENKILN_API_KEY"

翻页期间新建的任务不会打乱尚未读取的页面：游标标记的是一个时间位置，后续页面只包含更早的任务。