下载 Markdown

更新日期

任务查询

图和视频共用一条轮询路径。创建仍走各自接口,拿到 id 后都用这里查进度。

{id} 就是创建响应里的 id:生图异步为 img_…,生视频为 video_…。只能查本租户的任务。别人的 id 或未知 id:404(code 为 model_not_found,param 为 id)。余额为 0 时仍可 GET。这条路径不计 RPM。

创建:

  • 生图:POST /v1/images/generations — async: true 时立即返回任务 id;默认同步也会落任务记录(门户/管理端任务列表可见),同步成功体不含 id
  • 生视频:POST /v1/videos,始终返回任务 id

公共字段

字段类型说明
idstring任务对外 id:生图 img_…,生视频 video_…
objectstringimage 或 video,决定完成后的结果形状
modelstring对外模型 id
statusstring见下表
progressint0–100
created_atintUnix 秒
completed_atint | null未完成时为 null
errorstring | null成功为 null,失败为说明字符串

客户可见 status:

对外内部在做什么
queued已受理
in_progress生成中,或已生成正在转存(未关闭转存的模型)
completed生成完成,可取结果 URL
failed失败或超时;error 为说明字符串

内部「转存中」对外仍是 in_progress,此时还没有结果 URL;生成成功后即已扣费,转存失败不会退还。视频模型可关闭产物转存,完成后直接返回上游地址(无法安全直出时自动回退转存)。

轮询

建议 2–5 秒一次,直到 completed 或 failed。不要用创建请求一直挂着等。

curl https://tokenmei.com/v1/tasks/video_a1b2c3d4e5f6 \
-H "Authorization: Bearer $MOMO_API_KEY"

完成后:视频

object 为 video。结果在 url。

json
{
  "id": "video_a1b2c3d4e5f6",
  "object": "video",
  "model": "YOUR_VIDEO_MODEL",
  "status": "completed",
  "progress": 100,
  "created_at": 1710000000,
  "completed_at": 1710000120,
  "error": null,
  "url": "https://cdn.example.com/v/xxx.mp4",
  "usage": {
    "seconds": 5,
    "cost": { "amount": "0.5000", "currency": "CNY" }
  }
}
字段类型说明
urlstring视频结果地址:默认是平台转存后的稳定地址;关闭转存的模型可能直接返回上游地址
usage.secondsint计费秒数
usage.costobject可选,对外售价

完成后:生图

object 为 image。结果在 data(与同步生图一致)。同步多图会返回全部转存 URL;异步 worker 路径当前按单结果 URL 落一张。

json
{
  "id": "img_a1b2c3d4e5f6",
  "object": "image",
  "model": "YOUR_IMAGE_MODEL",
  "status": "completed",
  "progress": 100,
  "created_at": 1710000000,
  "completed_at": 1710000060,
  "error": null,
  "data": [
    { "url": "https://cdn.example.com/a/xxx.png", "revised_prompt": null }
  ],
  "usage": {
    "images_generated": 1,
    "cost": { "amount": "0.2200", "currency": "CNY" }
  }
}
字段类型说明
dataarray与同步生图一致;同步可多张,异步 worker 当前多为单张
data[].urlstring转存后的稳定地址
data[].revised_promptnull固定为 null
usage.images_generatedint实际张数
usage.costobject可选,对外售价
任务查询 · MomoAI算力超市