API v1

常见问题

计费、失败、结果保存时间和 API 密钥的常见问题。

查看 Markdown
本页内容

没有找到答案时,带上 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 天,控制台可以查看通知记录。无论回调是否到达,任务的状态和结果都以查询任务为准。

下一步