常见问题
任务一直是 pending 或 queued，正常吗？
Section titled “任务一直是 pending 或 queued，正常吗？”正常。接口是异步的，排队时间没有上限：平台繁忙或平台账号暂时不可用时，P2 任务会留在队列里等待恢复。服务端不会因为等太久把任务判为失败。你可以：
- 继续按 15 秒左右的间隔轮询；
- 对时效敏感的任务改用 P1；
- 参考平台列表里各平台的
p50_duration_seconds和状态，避开正在波动的平台。
见任务生命周期。
提交接口超时了，重新提交会不会扣两次费？
Section titled “提交接口超时了，重新提交会不会扣两次费？”可能会。每次调用提交接口都会创建一个新任务，两个任务都成功就会扣两次点数。超时后请先用任务列表按问题文本和时间查找刚才的任务，确认没有创建再重新提交。见提交结果未知时。
有 Webhook 回调吗？
Section titled “有 Webhook 回调吗？”目前没有，任务结果需要轮询获取。建议每 15 秒左右查询一次未结束的任务。
可以取消已经提交的任务吗？
Section titled “可以取消已经提交的任务吗？”开放 API 目前不提供取消接口。不需要的任务可以不再查询；任务成功仍会扣点数。
同一个问题问两次，结果不一样？
Section titled “同一个问题问两次，结果不一样？”正常。AI 的回答天然有随机性，每次提问得到的措辞、推荐和引用都可能不同。每次提交都是一次独立的真实提问，结果会分别保存。
started_at 为什么是 0？
Section titled “started_at 为什么是 0？”如果任务直接拿到了最终结果、中间没有观察到「执行中」状态，就不会记录开始时间。计算耗时请用 finished_at - created_at（含排队）或 raw_result.elapsedMs（仅执行）。
任务结果保存多久？
Section titled “任务结果保存多久？”控制台的调用日志可以查询近 30 天的记录。建议拿到结果后及时保存到你自己的系统。
为什么 HTTP 状态码是 200，请求却失败了？
Section titled “为什么 HTTP 状态码是 200，请求却失败了？”开放 API 的业务结果看响应体里的 ret：1 为成功，其他值为失败，HTTP 状态码都是 200。见 API 概述。
一直返回 1030 怎么办？
Section titled “一直返回 1030 怎么办？”1030 表示 API Key 缺失、无效、已停用或已过期。检查环境变量是否读到了完整的 Key、请求头是否为 Authorization: Bearer <Key>，并在控制台确认 Key 的状态。见认证与 API Key。
返回「请求包含不支持的字段」？
Section titled “返回「请求包含不支持的字段」？”请求体里出现了接口未定义的字段，最常见的是把 task_id、wait_seconds 写成了小驼峰 taskId、waitSeconds。开放 API 的请求字段都是下划线风格。
可以在网页前端、小程序或 App 里直接调用吗？
Section titled “可以在网页前端、小程序或 App 里直接调用吗？”不要这样做。API Key 会随前端代码暴露给所有用户，任何人都可以用它消耗你的点数。请在你的服务端调用开放 API，再把结果返回给前端。
有官方 SDK 吗？
Section titled “有官方 SDK 吗？”目前没有。接口只有四个，都是「POST + JSON」，用任何 HTTP 客户端几行代码即可封装，参考快速开始。
有测试环境或沙箱吗？
Section titled “有测试环境或沙箱吗？”目前没有独立的沙箱。调试可以用控制台的在线调试，或用少量真实请求验证——查询类接口不消耗点数，失败的任务也不扣费，首次使用赠送的 1000 点也可以用来测试。
任务成功了，但 references 是空的？
Section titled “任务成功了，但 references 是空的？”正常。有的问题平台没有联网搜索，回答就不带引用来源。succeeded 只表示拿到了回答。
回答里的 [citation:1]、【turn0search2】 是什么？
Section titled “回答里的 [citation:1]、【turn0search2】 是什么？”是平台自己的引用标记，我们原样保留在 answer 和 rawContent 中，不做转换。展示前可以按需清洗，判断引用关系请用 references 和 cited。见解析回答结果。
cited 字段有时候没有？
Section titled “cited 字段有时候没有？”cited 是三态：true 被正文引用，false 搜到但没引用，字段不存在表示这个平台不区分是否引用，不能当作 false。
references 里的 url 不是一个链接？
Section titled “references 里的 url 不是一个链接？”少数平台的来源没有链接，或给出的是平台内部 ID。使用 url 前请校验是否以 http:// 或 https:// 开头。
能指定模型、开启深度思考或联网搜索吗？
Section titled “能指定模型、开启深度思考或联网搜索吗？”可以开启思考：提交时传 "thinking": true，平台会以思考模式回答（如 DeepSeek 的深度思考、豆包的专家模式），默认关闭，不加价。部分平台没有思考开关，会按关闭执行；实际是否开启看结果里的 raw_result.thinking。见思考模式。
不能指定模型，也不能开关联网搜索，这些由各平台的抓取方式决定。平台是否进行了搜索，可以从结果的 agentSteps 和 references 看出来。
能基于上一次回答继续追问（多轮对话）吗？
Section titled “能基于上一次回答继续追问（多轮对话）吗？”不能。每个任务都是一次独立的单轮提问。raw_result 里的 conversationId 仅供对照，不能用于继续对话。
平台显示「波动」，还能用吗？
Section titled “平台显示「波动」，还能用吗？”可以提交。「波动」表示近期观察到失败，可能更慢或偶发失败，失败不扣费。「维护中」的平台暂停接单，提交会直接返回 1029。见平台状态。
有免费额度吗？
Section titled “有免费额度吗？”有。第一次使用开发者平台时会自动向你的个人账户赠送 1000 点，永久有效，每个账号一次。见获取点数。
失败的任务扣费吗？
Section titled “失败的任务扣费吗？”不扣。只有 succeeded 的任务扣点数；failed、canceled 以及被拒绝的提交都不扣，提交时预占的点数会退回。见计费与点数。
MCP 调用和 API 调用计费一样吗？
Section titled “MCP 调用和 API 调用计费一样吗？”一样。MCP 工具底层就是开放 API，共用同一个账户的点数余额、单价和限流额度。
团队里多个人能共用一个账户的点数吗？
Section titled “团队里多个人能共用一个账户的点数吗？”团队账户暂未开放，API Key 和点数都属于个人账户。团队内部可以按项目在同一个账号下创建多个 Key，在用量统计里按来源拆分消耗。