1. 常见误区
考拉
  • 价格-充值-分组-模型价格介绍
  • 站点操作指南-快速上手调用大模型API
  • 接入教程
    • IDE 与 AI 编程助手
      • Cursor 配置指南
      • VS Code 配置指南
      • Gemini CLI 配置指南
      • Trae 配置指南 (插件配置)
      • OpenCode 桌面端 配置指南
      • OpenCode CLI 配置指南 (CC Switch)
      • MiMoCode CLI 安装与配置 koalaapi
      • ChatGPT(Codex) CLI 安装与配置 koalaapi
      • ChatGPT(Codex) 桌面端 安装与配置 koalaapi
      • Claude Code 桌面端 安装与配置 koalaapi
      • Claude Code CLI 安装与配置 koalaapi (CC Switch)
      • Claude Code CLI 安装与配置 koalaapi (Win/Mac)
    • 桌面客户端
      • WorkBuddy 接入koalaapi教程
      • koalaapi接入chatbox
      • koalaapi接入Cherry Studio
    • 工作流与自动化
      • CC Switch 安装与配置教程
      • CC Switch 导入 koalaapi 令牌(API-KEY)
      • Claude Code + CC Switch 配置 DeepSeek | GLM 模型
      • n8n 配置使用 koalaapi 教程
      • Dify 配置使用 koalaapi教程
      • Coze 配置使用 koalaapi教程
    • 开源项目与部署
      • 腾讯云OpenClaw接入koalaapi教程
      • OpenClaw 接入 koalaapi 教程
      • OpenClaw Web 界面配置 koalaapi
      • OpenClaw 在云服务器Linux环境下通过终端配置 koalaapi
      • Hermes Agent Linux安装接入 koalaapi 教程
      • Hermes Agent CLI 安装与配置 koalaapi(CC Switch)
      • Pi Coding Agent 配置 koalaapi 教程
  • 模型接口
    • OpenAI
      • 文本模型
        • 文本生成
        • 上下文阅读
        • 函数调用 tools
        • v1/Responses / 通用
        • PDF文件分析
        • 联网搜索 Web Search
        • Response_Format
      • Embedding 模型
        • 创建文本嵌入
        • 批量创建嵌入
      • 图像模型
        • 图片生成(统一接口 · 支持多模型)
        • 图像编辑(统一接口 · 表单上传 / JSON 双模式)
        • 图片理解(多模态视觉分析)
    • Anthropic Claude
      • 原生接口
        • 文本生成 (思考配置)
        • 图片理解
        • 文本生成
        • 文本生成 / 强制返回思考
        • 函数调用
        • Web search / 联网搜索
      • OpenAI兼容接口
        • 文本生成
        • 图片理解
        • 文本生成 / 强制返回思考
        • 函数调用
        • Web search / 联网搜索
    • Google Gemini
      • OpenAI兼容接口(推荐)
        • 文本生成
        • 文本生成 / 强制返回思考
        • 图片理解
        • 图片生成
        • 图片修改
        • 音频理解
        • 视频理解
        • 文本转语音 / TTS
        • 图片编辑(Nano-banana)
        • 图片编辑(Nano-banana) base64格式
      • Google Gemini接口
        • 文本生成
        • 文字转语音
        • 音频转文
        • 视频转文
        • 图片理解
        • 文生图片(nanobanana pro)
        • 图片编辑(nanobanana)
        • 图片编辑(nanobanana pro)
  • 平台接口
    • 获取个人token
    • 用户信息管理
      • 1. 获取个人信息
      • 2. 修改个人信息
      • 3. 注销账户
      • 4. 获取可用模型列表
      • 5. 获取用户分组
      • 6. 更新用户设置(额度预警等)
      • 7. 生成系统访问令牌
    • 令牌管理(API Key)
      • 1. 获取令牌列表
      • 2.搜索令牌
      • 3. 获取单个令牌
      • 4.创建令牌
      • 5.更新令牌
      • 6. 删除令牌
      • 7.批量删除令牌
      • 8.获取单个令牌(明文显示)
    • 日志与数据统计
      • 1. 查看个人使用日志
      • 2. 个人日志统计
      • 3. 令牌每日消耗
      • 4. 令牌模型消耗预览(Top 3)
      • 5. 令牌全量模型消耗
      • 6. 导出令牌每日消耗 XLSX
      • 7. 个人额度时序数据
  • 常见问题
    • 问题自查方法
    • 入门必看
      • 如何在 koalaapi 充值?
      • 可以使用哪些 大模型API ?
      • 如何获取 OpenAI Key ? 如何获取 Claude Key ? 如何获取 Gemini Key ?等等
      • 我注册并且充值了,key 在哪?
      • 怎么更换模型使用?
      • 配置模型的时候 URL 用哪个?
      • 接口在中国大陆能使用吗?
      • 按量计费还是按月支付?
      • 怎么检查一次调用消耗了多少 Token?
      • 请问我余额为负了怎么回事?
    • 常见误区
      • 明明余额还有很多,为什么显示令牌无法使用?
      • Key 为什么不能用?为什么我调用 API 没反应?
      • 新建令牌参数怎么填?
      • 为什么调用接口返回“无效的令牌”?
      • API 接口返回报错,报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思?
  • 数据模型
    • 示例数据模型
      • 未命名数据模型
      • Pet
      • Category
      • Tag
  1. 常见误区

API 接口返回报错,报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思?

状态代码代码解释
400 Bad Request请求格式错误或不能被服务器理解,通常意味着客户端错误,请检查你的请求格式,例如 o1 系列模型不支持 system 参数。
401 Unauthorized(无效的令牌)API 密钥验证未通过,你需要验证你的 API 密钥是否正确,其他原因还包括令牌过期。换个模型测试来验证你的API密钥是否正确。如果你换模型正常,请联系管理员反馈处理。
403 Forbidden / 令牌分组 XXX 已被禁用一般是权限不足,令牌权限问题或令牌限额用完。编辑令牌取消令牌限额 或 新建令牌可以解决。
404 Not Found请求的资源未找到,你可能正在尝试访问一个不存在的端点。请检查 Base Url是否填写正确,尝试带上 /v1 或最后一个斜杠 / 等。
413 Request Entity Too Large请求体太大,你可能需要减小你的请求体容量。Prompt可能超长了。请缩短你的prompt,再次尝试,确认短prompt是否可以正常调用。
429 Too Many Requests / 当前分组上游负载已饱和由于频繁的请求超过限制,你已经超过了你的速率限制。OpenAI 对单个账号有限流,429 说明后端某个账号并发太高遇到限流,请继续尝试。
500 Internal Server Error服务器内部的错误,这可能是中转服务器或 OpenAI 服务器的问题,不是你的问题。请再次尝试,多次持续报错请联系管理员处理。
503 Service Unavailable / 当前分组 NNN 下对于模型 xxxx 无可用渠道服务器暂时不可用,这可能是由于 OpenAI 正在进行维护或者服务器过载。也可能是中转平台后端管理的问题,请联系管理员,让他帮你加上这个模型。请再次尝试,多次持续报错请联系管理员处理。
504 Gateway Timeout504 错误表示“网关超时”,未能在规定时间内从上游服务器获得响应。请再次尝试,多次持续报错请联系管理员处理。
524 连接超时服务器没有在规定时间内完成请求,可能是 KoalaAPI 通道拥挤造成。请再次尝试,多次持续报错请联系管理员处理。
注意: 以上只是 HTTP 状态码的一部分,并不完全,有些状态码可能会因服务器的实现和使用而有所不同。
修改于 2026-11-05 08:31:51
上一页
为什么调用接口返回“无效的令牌”?
下一页
未命名数据模型
Built with