常见问题
计费、失败、结果保存时间和 API 密钥的常见问题。
本页内容
没有找到答案时,带上 trace_id 或任务 ID 联系我们。
计费
任务失败会收费吗?
不会。失败或取消的任务结算后,最终费用和应收金额都是零,预留全额释放。详见「计费方式」。
为什么创建时预留的金额比最后的费用多?
创建时按这次请求可能产生的最大用量预留,完成后按实际用量结算,多出的部分释放回余额。
任务
请求超时了,要重新发吗?
要,用原请求体和同一个 Idempotency-Key 重发。如果上一次其实已经成功,会返回原来的任务,不会重复创建或扣费。详见「幂等与重试」。
能取消正在生成的任务吗?
只能在生成开始前取消。生成开始后取消返回 not_effective,任务会继续生成并照常结算。
结果能保存多久?
结果保存到 expires_at,默认是结果准备好后 7 天。每次查询任务都会返回新的 url,最长 24 小时有效,且不晚于 expires_at。请在有效期内下载到自己的存储,过期后 url 为空。
为什么查不到某个任务?
任务按团队隔离。任务 ID 不存在或属于其他团队时都返回 404 task_not_found。
API 密钥和回调
API 密钥泄露了怎么办?
立刻在控制台的「API 密钥」页停用它,新建一把并替换服务器上的值。
没收到回调怎么办?
先确认回调地址在控制台已验证且没有撤销,创建任务时 callback_url 与登记的地址逐字节相同。失败的投递会重试 7 天,控制台可以查看通知记录。无论回调是否到达,任务的状态和结果都以查询任务为准。