跳到正文
九维AI开放平台使用文档

问题排查

异步任务一直生成中怎么办:查询、超时与冻结余额

解释图片视频音乐的任务状态、查询暂停与真实失败的区别,指导继续查看历史任务并核对冻结和结算。

成都九维数创科技有限公司 · 文档团队更新于 约 5 分钟阅读
本页目录
  1. 提交与完成是两个阶段
  2. 从最近创作继续查看
  3. 网络超时不等于任务失败
  4. 冻结金额为什么还在
  5. API 用户如何查询
  6. 提交问题前准备的信息

提交与完成是两个阶段#

媒体生成可能先返回 task ID 或 job ID,表示任务已被接收,不表示内容已经完成。平台保留预计费用冻结,随后通过查询或回调获取终态。

状态用户应做什么
处理中/预冻结等待原请求状态确认
生成中查询原任务,避免重复创建
已完成查看结果并核对费用
失败查看错误和冻结释放情况
查询已暂停继续从最近创作查看原任务

从最近创作继续查看#

在Playground的最近创作中找到对应任务,点击“查看”。仍处于 pending 的任务可继续查询;关闭页面或切换菜单,不会自动取消上游生成。

页面隐藏时会暂停前端查询,返回页面后继续。查询错误会退避重试;达到前端查询次数上限后停止自动查询,但不会把任务直接改为失败。

网络超时不等于任务失败#

结果查询超时或浏览器显示错误,只能说明这次查询没有得到结果。上游可能仍在生成,也可能已完成但暂未获取终态。

如果没有明确失败状态,不要连续创建替代任务来“刷新”。生成次数和费用可能因此增加。

冻结金额为什么还在#

终态尚未确认时,预计金额可能继续冻结。成功结算后释放差额,确认失败后释放冻结。较长时间仍无变化时,请提交任务 ID与创建时间,由客服核查。

不要仅凭本地计时判定必须退款;需要结合实际任务与账本状态。

API 用户如何查询#

使用同一账户下的有效密钥,按供应商对应的查询端点查询原任务。不同媒体协议可能有不同路径;不能把所有任务 ID塞进一个通用路径后假定都能查询。

本站校验任务归属,其他账户的密钥不能查看你的任务。批量查询需满足任务数量和渠道范围限制,具体接入请结合所用模型的协议。

提交问题前准备的信息#

任务 ID、模型与规格、创建时间、最后一次查询时间、当前状态和冻结记录。不要发送完整密钥,敏感素材可先描述问题再通过客服要求提供。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground