状态、费用与重试
接口说明
HTTP 200 表示本次请求已处理。先看 status,再看 settled,决定下一步。
| 状态 | 含义 | 下一步 |
|---|---|---|
submitting | 正在提交 | 等待受理,服务费已预留。 |
queued | 等待处理 | 可尝试取消,取消结果以服务端为准。 |
processing | 正在处理 | 继续刷新状态。 |
awaiting_otp | 等待验证码 | 填写邮箱验证码,再查询结果。 |
unknown | 等待核实 | 受理结果不明,积分继续预留,联系管理员。 |
succeeded | 任务成功 | 确认平台服务费消费;订阅退款到账另查账单。 |
failed | 任务失败 | 退回该任务预留的服务费。 |
cancelled | 任务已取消 | 退回该任务预留的服务费。 |
skipped | 未受理 | 合并或未受理的任务,释放多预留的服务费。 |
常见错误
业务错误返回 {"detail":"可读错误说明"},网关鉴权错误还可能包含 error 对象。
| HTTP 状态 | 含义 | 建议处理 |
|---|---|---|
400 | 请求格式、账号或验证码无效 | 修正参数;检查账号数、体积与幂等请求头。 |
401 | API Key 不可用 | 使用有效的本站 API Key;Cookie 不能代替密钥。 |
402 | 积分或额度不足 | 检查账户积分、团队成员额度和 API Key 剩余额度。 |
403 | 账户或团队不可用 | 联系管理员确认账户状态。 |
404 | 任务不存在或无权访问 | 确认本站任务编号与账户归属。 |
409 | 版本、重复账号或当前状态冲突 | 先查看任务;费用版本变更时重新获取目录并确认。 |
500 / 502 / 503 | 处理异常或服务暂时不可用 | 创建结果可能不确定,先查历史;保留原请求及幂等标识。 |
积分与 API Key 额度
每个任务的服务费同时预留账户积分与 API Key 累计额度;批次额度不足时整批不提交。任务成功才计入 Key 已用额度,失败、取消或 skipped 时释放预留。撤销 Key 不影响已有任务结算。积分流水记录 Key 信息,可按 Key 筛选,保留 30 天。
团队成员沿用团队钱包与成员额度。目录、查询、刷新、验证码和取消接口不另收平台服务费。本应用不参与代理分佣;模型单价保护不用于应用服务费。
去重、幂等与不确定结果
本地按可识别的账号身份合并重复输入,受理时也可能继续去重,未受理的任务标为 skipped 并释放费用。同一本站账户内有未结算任务的已知账号不能再次提交。不保证不同格式的所有凭据都能识别为同一账号。
提交前保存 Idempotency-Key。超时或 unknown 后先查询历史,保留原请求及原幂等标识;不要用新标识盲目重试。unknown 持续预留服务费,需要管理员核实后处理。
账号凭据与验证码
完整 Session、Access Token、邮箱凭据和验证码不写入本站任务记录或日志,只用于本次处理。任务返回脱敏邮箱;不要按返回数组位置推断账号对应关系。从服务端调用,避免把本站 API Key 暴露在客户端。