Skip to Content

HTTP 状态码

调用 AcceleAI API 时可能遇到以下错误状态码。本文列出常见错误及其排查方法。

400 Bad Request

请求参数无效，服务器无法处理。

常见原因解决方案
无效的 channel ID 格式检查请求参数格式
图像生成缺少 prompt确保必填参数已提供
prompt 超出长度限制缩短提示词内容
音频输入文本过长减少输入文本长度
不支持的图像尺寸参考模型文档中的允许尺寸
n 参数值不合法检查生成数量是否在允许范围内
{
  "error": {
    "message": "Invalid parameter: size must be one of 1024x1024, 1536x1024, 1024x1536",
    "type": "invalid_request_error",
    "code": "invalid_parameter"
  }
}

401 Unauthorized

身份验证失败。

常见原因解决方案
未提供 Authorization 请求头在 Header 中添加 Authorization: Bearer <ACCELE_AI_API_KEY>
API Key 无效或已过期前往 API Key 管理页  确认或重新生成

检查方法：

curl https://api.acceleai.cn/v1/models \
  -H "Authorization: Bearer <ACCELE_AI_API_KEY>"

如果返回模型列表，说明 Key 有效；如果返回 401，需要重新获取 Key。

403 Forbidden

请求被拒绝，权限不足。

常见原因解决方案
账户余额不足前往 控制台  充值
账户被暂停联系客服了解详情
用户角色权限不足确认账户权限等级
API Key 未授权访问该模型检查 Key 的模型访问权限
IP 不在白名单内在 Key 设置中添加当前 IP

余额不足是 403 最常见的原因。请先在 使用详情页  确认余额情况。

429 Too Many Requests

请求频率超过限制。

常见原因解决方案
短时间内请求过于密集添加请求间隔，实施指数退避重试
上游模型服务商限流稍等片刻后重试

建议的重试策略：

import time
import random
 
def call_with_retry(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except Exception as e:
            if "429" in str(e) and attempt < max_retries - 1:
                wait = (2 ** attempt) + random.random()
                time.sleep(wait)
            else:
                raise

503 Service Unavailable

服务暂时不可用。

常见原因解决方案
模型 ID 填写错误核对文档中的模型名称，注意大小写
无权访问该模型确认账户是否有该模型的使用权限
上游服务商限流稍后重试，或联系客服申请提升并发额度

模型名称拼写错误是 503 的高频原因。建议先通过 GET https://api.acceleai.cn/v1/models 获取可用模型列表进行确认。

通用排查建议

  1. 确认 API Key 有效：前往 https://api.acceleai.cn/keys  检查
  2. 确认余额充足：前往 https://api.acceleai.cn/usage  查看
  3. 确认端点正确：OpenAI 兼容接口为 https://api.acceleai.cn/v1，Gemini 原生接口为 https://api.acceleai.cn/gemini
  4. 确认模型名称正确：调用模型列表接口核实
  5. 查看完整错误信息：API 返回的 error.message 字段通常包含具体原因
常见问题服务状态