任务类接口(绘图 / 生成任务)
绘图、视频等异步任务不是一问一答:提交后立即返回任务号,再轮询查询结果。
典型流程
- 提交:向任务端点(
/mj/...、/suno/...等,取决于平台开放的平台类型)提交参数,拿到任务 ID。 - 轮询:按任务 ID 查询进度与结果(部分任务支持回调通知)。
- 取结果:任务完成后拿到图片/视频 URL;URL 通常有时效,请及时转存。
计费
| 环节 | 说明 |
|---|---|
| 提交时 | 按模型的按次/按张价格预扣 |
| 完成后 | 按实际档位(分辨率/时长/倍率)多退少补 |
| 失败时 | 任务失败会按平台规则退款,日志里有对应记录 |
任务类模型同样支持渠道容量保护与限免/折扣活动;命中活动时任务日志会写明让利比例与实扣。
与对话接口的区别
- 对话是同步的:一次请求一次响应。
- 任务是异步的:提交与结果分离,因此必须处理「排队中」「处理中」「失败」「已完成」四种状态。
常见问题
- 任务一直排队:上游拥塞;建议在应用侧设置轮询上限与超时,避免无限等待。
- 结果 URL 打不开:过期了,重新查询任务或及时转存。
- 想控制成本:在应用侧限制并发任务数,并在「智能路由」里为任务模型配置「价格优先」。