快速接入

约 5 分钟完成：网页注册拿 Key → 提交素材 → 轮询状态 → 下载成片。

1. 注册获取 API Key

请前往 开发者控制台 完成邮箱注册，注册默认赠送「成片额度」2 次、「加急额度」0 次。

2. 提交素材

curl -X POST http://kfz.oookay.cn/api/v1/tasks \
  -H "Content-Type: application/json" \
  -H "X-API-Key: jk_xxx" \
  -d '{
    "id": "1",
    "images": ["https://example.com/a.jpg"],
    "videos": ["https://example.com/b.mp4"]
  }'

成功返回 job_id 与 queue_ahead（前方排队人数）。每次成功提交消耗 1 次额度。

3. 查询状态与排队

curl http://kfz.oookay.cn/api/v1/tasks/job_xxx \
  -H "X-API-Key: jk_xxx"

status：pending（排队）/ running（处理中）/ success / failed。建议 5～10 秒轮询一次。

4. 下载成片

任务成功后，成片已保存在开放平台服务器。保留 1 小时，请尽快下载；过期将自动删除。

curl -L http://kfz.oookay.cn/api/v1/tasks/job_xxx/download/1 \
  -H "X-API-Key: jk_xxx" -o out1.mp4

额度不足？

前往 额度与兑换 扫码闲鱼购买兑换码，再调用 POST /api/v1/redeem。