问题处理

先看人话原因，再决定要不要重试。

失败不会正式消耗免费额度或付费余额。不要遇到错误就连续提交，先按下面四个方向确认问题。

最常见的四类问题

填

填写内容不正确

视频链接不属于所选平台、不是 HTTPS 官方链接，或者商品关键词太短。

先修改输入，再提交

账

账户或 API 令牌不可用

免费额度和付费余额不足，或者 API 令牌无效、已撤销、过期或没有当前接口权限。

先检查账户和令牌

等

请求太多或仍在处理

短时间提交过于频繁，或者相同查询还没有完成。

等待后再试，不要连续点击

数

暂时取不到完整数据

内容失效、平台响应慢或结果缺少关键字段，系统会把本次费用归还。

稍后重试或更换内容

程序接入错误对照

这一段给程序接入使用；只在网页里操作可以跳过。

填写内容不符合要求检查链接、平台、关键词和返回数量后重新提交。

程序提示代码

INVALID_ARGUMENT

API 令牌不可用确认令牌完整、没有过期且尚未被撤销。

程序提示代码

UNAUTHORIZED

令牌没有这个接口的权限创建或编辑一枚允许使用当前接口的 API 令牌。

程序提示代码

FORBIDDEN

没有找到这个数据接口返回接口目录，选择当前已经开放的接口。

程序提示代码

CAPABILITY_NOT_FOUND

接口暂时停止使用暂时不要连续重试，稍后查看状态或联系管理员。

程序提示代码

CAPABILITY_DISABLED

可用额度不足免费额度和付费余额都不足以支付本次调用。多枚 API 令牌共享同一账户额度。

程序提示代码

INSUFFICIENT_BALANCE

防重复编号与之前的内容冲突程序接入时为新的请求生成新的唯一编号。

程序提示代码

IDEMPOTENCY_CONFLICT

查询结果保存期已结束调用记录和费用仍可查看；若需再次获得数据，请用新的防重复编号重新查询。

程序提示代码

RESULT_EXPIRED

相同请求仍在处理中不要重复提交，稍等后在调用记录里查看结果。

程序提示代码

REQUEST_IN_PROGRESS

提交得太频繁降低并发或等待片刻后重试。

程序提示代码

RATE_LIMITED

数据接口暂时无法取得数据稍后重试；如果持续出现，请保留查询编号。

程序提示代码

UPSTREAM_UNAVAILABLE

查询等待超时内容本身可能响应较慢，可以稍后重试一次。

程序提示代码

UPSTREAM_TIMEOUT

结果不完整系统不会对本次结果结算，临时占用的额度会归还；稍后重试或更换内容。

程序提示代码

INVALID_RESULT

服务暂时异常本次不会结算。稍后重试并保留查询编号。

程序提示代码

INTERNAL_ERROR

✓

失败、超时或结果不完整都不会正式结算

如果失败后的可用额度没有恢复，请先停止继续提交，并把查询编号交给管理员核对。

先看人话原因，再决定要不要重试。

最常见的四类问题

填写内容不正确

账户或 API 令牌不可用

请求太多或仍在处理

暂时取不到完整数据

推荐的排查顺序

读页面上的中文说明

打开工作台的调用记录

按提示只重试一次

保留查询编号

程序接入错误对照