DMXAPI 返回状态码详解

TIP

状态码是 HTTP 协议的一部分，用于表示请求的处理结果。

状态码分为五大类：

• 1xx：信息性状态码，表示请求正在处理中。API 调用中基本见不到。
• 2xx：成功状态码，表示请求成功。
• 3xx：重定向状态码，表示请求需要进一步操作。API 调用中基本见不到。
• 4xx：客户端错误状态码，表示请求错误。往往是客户端的请求问题，请根据以下表格排查问题，如果问题依旧存在，请联系管理员。
• 5xx：服务器错误状态码，表示服务器错误。一般是中转平台后端的问题，请了解错误原因后向管理员反馈。

状态码	描述	类型	解释	DMXAPI 说明
200	OK	成功	操作将在响应正文中返回数据	说明调用成功
204	No Content	成功	操作成功但不返回数据	说明调用成功
301	Moved Permanently	重定向	资源已永久移动	通常发生在网页请求中，浏览器会自动跳转。
302	Found	重定向	资源临时移动	通常发生在网页请求中，浏览器会自动跳转。
304	Not Modified	重定向	资源未修改	通常发生在网页请求中，表示资源未修改，使用本地缓存资源。
400	Bad Request	客户端错误	参数无效	请检查你的请求格式，一般都是客户端错误。例如 o1 系列模型不支持 system 参数。
401	Unauthorized	客户端错误	未授权	认证失败，通常是 API 密钥令牌无效、过期或格式错误。请检查您的 API 密钥是否正确填写，或尝试重新生成新的 API 密钥以及新的模型尝试。
403	Forbidden	客户端错误	禁止访问	一般是令牌权限问题或令牌限额用完。编辑令牌 取消令牌限额 或 新建令牌 可以解决。
404	Not Found	客户端错误	资源不存在	通常是请求资源链接的错误，请检查 Base Url 是否填写正确，例如尝试带上 /v1 或最后一个斜杠 /。
405	Method Not Allowed	客户端错误	方法不允许	请求方法（GET、POST、PUT、DELETE 等）与资源不兼容。例如，对只支持 GET 的端点使用了 POST 方法。
413	Payload Too Large	客户端错误	请求长度过长	Payload 中常见的是 prompt 过长。请缩短你的 prompt，再次尝试，确认短 prompt 是否可以正常调用。
429	Too Many Requests	客户端错误	请求过多	一般是当前分组上游负载已饱和，通常 OpenAI 对单个账号有限流，429 说明后端某个账号并发太高遇到限流，请继续尝试。
500	Internal Server Error	服务器错误	服务器内部错误	服务器内部的错误。可能是中转服务器或OpenAI服务器的问题，不是你的问题。请再次尝试，多次持续报错请联系管理员处理。
501	Not Implemented	服务器错误	未实施请求的操作	通常说明 API 不支持你的请求，请按照 API 文档及参数排查请求。也有可能尚未接入该 API，请联系管理员。
503	Service Unavailable	服务器错误	服务不可用	例如 当前分组下对于模型 xxxx 无可用渠道，中转平台后端管理的问题，请联系管理员，让他帮你加上这个模型。请再次尝试，多次持续报错请联系管理员处理。
504	Gateway Timeout	服务器错误	网关超时	未能在规定时间内从上游服务器获得响应。请再次尝试，多次持续报错请联系管理员处理。
524	Connection Timeout	服务器错误	连接超时	服务器没有在规定时间内完成请求，可能是DMXAPI通道拥挤造成。请再次尝试，多次持续报错请联系管理员处理。