API 文档v0.9.11 Base URL https://jusouai.cnBearer 鉴权1–4 积分/次,Exa 部分参数另加 MarkdownOpenAPISKILL.md
开发文档 / 通用参考

错误码与怎么办

错误统一返回下面的结构:error.message 说发生了什么,error.hint 说怎么办,request_id 可用于对账与反馈。所有错误都不扣分。

HTTPcode什么时候怎么办(error.hint)积分
400invalid_request参数错误(网关拦截或引擎判定参数错)看 message 里说的是哪个参数,改好再试;本次未扣积分不扣
400operation_unavailable该引擎的这个接口 / 档位暂未开放这个接口或档位暂未开放,换默认档或该引擎的其他接口不扣
400invalid_code兑换码无效或已被使用核对卡密是否抄错、是否已兑换过;仍不行请联系购买处—
401unauthorized缺少密钥或密钥无效检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制不扣
402insufficient_points积分不足兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分不扣
403forbidden账户已停用账户已停用,请联系客服不扣
404engine_not_found引擎不存在检查引擎名是否写错,GET /v1/engines 可查看全部引擎不扣
404endpoint_not_found该引擎没有这个接口检查接口路径,该引擎的接口见 /docs/<引擎名>不扣
429rate_limited超过套餐每秒请求数(排队超过上限)稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐不扣
429engine_busy引擎繁忙稍等几秒再试,或用 engine 换一家不扣
502engine_error引擎暂时异常(已自动重试)稍后重试(已自动重试过);着急可用 engine 换一家,本次未扣积分不扣
503engine_unavailable引擎暂不可用或暂未开放稍后再试,或用 engine 换一家已开放的引擎;本次未扣积分不扣
500internal_error服务内部错误稍后重试;多次出现请带上 request_id 反馈不扣

原生接口在引擎判定参数错时,原样返回该引擎的错误结构(HTTP 400),另加 billing(本次未扣)。

错误响应
{
  "error": {
    "code": "insufficient_points",
    "message": "积分不足:本次需要 5 积分,当前可用 3;请兑换新的卡密续费(同一个 Key 自动叠加),本次未扣积分",
    "hint": "兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分"
  },
  "request_id": "js-20261102120000-a1b2c3d4e5f6"
}