木瓜AI开放平台
    • 介绍
    • 新手指南
    • 基础知识
    • 充值和费用
    • 身份验证
    • 发出请求
    • 常见错误码
    • 模型(Models)
      • 列出模型
        • 原生OpenAI格式
        • 原生Gemini格式
    • 聊天(Chat)
      • 原生OpenAI格式
        • ChatCompletions格式
        • Responses格式
      • 原生Gemini格式
        • Gemini文本聊天
        • Gemini媒体识别
      • 原生Claude格式
        POST
    • 图像(Images)
      • OpenAI格式
        • GPT-image-2生图
        • GPT-image-2-pro生图
        • GPT-image-2-pro参考图改图
        • 通用-生成图像
      • Gemini格式
        • 官方格式生图
      • 豆包格式
        • OpenAI对话格式生图
    • 视频(Videos)
      • sora和veo视频
        • 视频生成 - sora
        • 任务查询进度
        • 视频生成- VEO
        • 创建角色
      • grok
        • 视频拓展
        • 视频生成
        • 任务查询进度
    • 嵌入(Embeddings)
      • 原生OpenAI格式
        POST
      • 原生Gemini格式
        POST
    • 补全(Completions)
      • 原生OpenAI格式
        POST
    • 音频(Audio)
      • 原生OpenAI格式
        • 音频转录
        • 音频翻译
        • 文本转语音
      • 原生Gemini格式
        POST
    • 实时语音(Realtime)
      • 原生OpenAI格式
        GET
    • 重排序(Rerank)
      • 文档重排序
    • 审查(Moderations)
      • 原生OpenAI格式
    • web搜索和阅读
      • web search
      • web reader
    • 数据模型
      • Schemas
        • MjButton
        • User
        • Log
        • Model
        • Token
        • Usage
        • PageInfo
        • Channel
        • Redemption
        • ApiResponse
        • ModelsResponse
        • ErrorResponse
        • Message
        • MessageContent
        • Tool
        • ToolCall
        • GeminiModelsResponse
        • ChatCompletionResponse
        • ChatCompletionRequest
        • ChatCompletionStreamResponse
        • CompletionRequest
        • CompletionResponse
        • ResponseFormat
        • ResponsesRequest
        • ResponsesResponse
        • ResponsesStreamResponse
        • ClaudeRequest
        • ClaudeMessage
        • ClaudeResponse
        • EmbeddingRequest
        • EmbeddingResponse
        • ImageGenerationRequest
        • ImageEditRequest
        • ImageResponse
        • AudioTranscriptionRequest
        • AudioTranslationRequest
        • AudioTranscriptionResponse
        • SpeechRequest
        • RerankRequest
        • RerankResponse
        • VideoRequest
        • ModerationRequest
        • VideoResponse
        • ModerationResponse
        • VideoTaskResponse
        • GeminiRequest
        • VideoTaskMetadata
        • VideoTaskError
        • GeminiResponse
        • OpenAIVideo
        • OpenAIVideoError

    常见错误码

    错误排查指南#

    遇到错误时,请先查看返回的错误码,然后参考下表进行排查处理。

    错误码对照表 🎯#

    状态码说明解决方案
    400请求格式错误检查请求参数,例如o1系列模型不支持system参数
    401无效令牌检查API密钥是否正确,可换模型测试验证
    403令牌分组被禁用编辑令牌取消限额或新建令牌
    404接口不存在检查Base URL是否正确,尝试添加/v1或斜杠/
    413请求内容过长缩短prompt内容后重试
    429上游限流账号并发过高,稍后重试
    500服务器内部错误多次重试仍失败请联系管理员
    503模型不可用当前分组无该模型渠道,请检查模型名称是否正确,有没有多空格少空格之类。
    504网关超时上游服务器未及时响应,稍后重试
    524连接超时通道拥挤,稍后重试

    解答#

    400 错误码,一般是请求参数不匹配。先把 system 注释掉,先试试通不通。
    401 错误码 “无效令牌”,是因为令牌和API地址URL错配了。
    403 错误码,一般是 令牌额度 不够了(令牌额度和账户额度是两个概念)。 到令牌编辑里,点 “设为无限额度” 就可以了,一般等2分钟就能生效。 也可以新建一个令牌“设为无限额度”,试一下。
    404 错误码,大概率是 API地址 没正确设置。
    429 错误码,是模型达到流量限制的体现。简单说就是:用的人太多 造成模型达到 TPM 饱和了。 一般情况下,等会重试就可以使用。 如果持续不能使用,把模型名称给客服,客服会排查处理。
    503 错误码,请检查模型全称有没有错,模型全称到 顶部菜单 支持模型 页面查看。 如果模型名称没错,把模型名称发给客服,客服进行排查处理。
    修改于 2026-03-16 18:23:35
    上一页
    发出请求
    下一页
    原生OpenAI格式
    Built with