更新日期
任务查询
图和视频共用一条轮询路径。创建仍走各自接口,拿到 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
公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 任务对外 id:生图 img_…,生视频 video_… |
object | string | image 或 video,决定完成后的结果形状 |
model | string | 对外模型 id |
status | string | 见下表 |
progress | int | 0–100 |
created_at | int | Unix 秒 |
completed_at | int | null | 未完成时为 null |
error | string | 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。
{
"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" }
}
}| 字段 | 类型 | 说明 |
|---|---|---|
url | string | 视频结果地址:默认是平台转存后的稳定地址;关闭转存的模型可能直接返回上游地址 |
usage.seconds | int | 计费秒数 |
usage.cost | object | 可选,对外售价 |
完成后:生图
object 为 image。结果在 data(与同步生图一致)。同步多图会返回全部转存 URL;异步 worker 路径当前按单结果 URL 落一张。
{
"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" }
}
}| 字段 | 类型 | 说明 |
|---|---|---|
data | array | 与同步生图一致;同步可多张,异步 worker 当前多为单张 |
data[].url | string | 转存后的稳定地址 |
data[].revised_prompt | null | 固定为 null |
usage.images_generated | int | 实际张数 |
usage.cost | object | 可选,对外售价 |