任务与排队

提交素材后进入全局队列；同一时间下游只处理一个成片任务。你可以通过 queue_ahead 知道前面还有几个人。

创建任务

POST /api/v1/tasks

字段类型说明
idstring/number必填，用户 id（须为当前登录用户）
imagesstring[]图片 URL，与 videos 至少一个非空
videosstring[]视频 URL
prefer_quota_bbool可选，优先消耗额度 B

成功时扣除 1 次额度；若下游失败会自动退还额度。

查询任务

GET /api/v1/tasks/{job_id}

  • status：pending / running / success / failed
  • queue_ahead：前方排队人数（pending+running 中更早的任务数）
  • export_count：已导出成片数量
  • download_urls：可下载地址列表（仅未过期）
  • expires_at：成片过期时间（入库后约 1 小时）
  • expired：是否已过期不可下载

只查排队

GET /api/v1/queue

{
  "ok": true,
  "has_active": true,
  "job_id": "job_xxx",
  "status": "pending",
  "queue_ahead": 3,
  "queue_message": "前方还有 3 人排队",
  "global_queue": { "pending": 5, "running": 1 }
}

下载

GET /api/v1/tasks/{job_id}/download 或 .../download/{1-n}

成片由开放平台服务器代存后提供下载（无需直连手机）。自入库起保留 1 小时，过期后文件会物理删除，下载接口返回 410。

  • 仅 status=success 且未过期时可下载
  • 响应字段 expires_at 为过期时间；expired=true 表示已过期
  • 请求需携带 X-API-Key