黑马天启 · 多模型 Token 平台

任务类接口(绘图 / 生成任务)

绘图、视频等异步任务不是一问一答:提交后立即返回任务号,再轮询查询结果。

典型流程

  1. 提交:向任务端点(/mj/...、/suno/... 等,取决于平台开放的平台类型)提交参数,拿到任务 ID。
  2. 轮询:按任务 ID 查询进度与结果(部分任务支持回调通知)。
  3. 取结果:任务完成后拿到图片/视频 URL;URL 通常有时效,请及时转存。

计费

环节 说明
提交时 按模型的按次/按张价格预扣
完成后 按实际档位(分辨率/时长/倍率)多退少补
失败时 任务失败会按平台规则退款,日志里有对应记录

任务类模型同样支持渠道容量保护与限免/折扣活动;命中活动时任务日志会写明让利比例与实扣。

与对话接口的区别

  • 对话是同步的:一次请求一次响应。
  • 任务是异步的:提交与结果分离,因此必须处理「排队中」「处理中」「失败」「已完成」四种状态。

常见问题

  • 任务一直排队:上游拥塞;建议在应用侧设置轮询上限与超时,避免无限等待。
  • 结果 URL 打不开:过期了,重新查询任务或及时转存。
  • 想控制成本:在应用侧限制并发任务数,并在「智能路由」里为任务模型配置「价格优先」。