91model
    • 91model的注册和API的获取
    • AI 网关常见 HTTP 错误码说明
    • 用户使用常见问题解答手册
    • 前言-模型兼容性（必读）
    • OpenAI官方SDK使用教程
    • 高并发批量请求示例
    • Seedance 视频生成 API 调用文档（OpenAI 兼容格式）
    • Seedance 视频生成 API 调用文档（火山官方Seedance 原生格式）
    • Claude Code CLI接入API教程指南
    • OpenAi Codex CLI接入API教程指南
    • Gemini CLI接入API教程指南
    • OpenClaw 配置使用 API 教程
    • OpenCode 配置使用 API 教程
    • 多模型 AI 桌面客户端
      • WorkBuddy 使用支持指南
      • Cherry Studio 使用支持指南
      • Claude 桌面端 使用支持指南
      • Codex（chatgpt)使用支持指南
    • 模型信息
      • 列出可用模型
        GET
      • 列出单个模型
        GET
    • OpenClaw 专栏
      • 技能：OpenClaw接入vapi的nao-banana、gpt-image生图
    • 聊天模型（Chat）
      • /v1/chat/completions
        POST
      • 聊天接口（图片分析）
        POST
      • 聊天接口（函数调用）
        POST
      • 聊天接口（o1-o3系列模型）
        POST
      • Claude (OpenAI格式)-可PDF分析
        POST
      • Claude (原生格式)-可PDF分析
        POST
      • Gemini (OpenAI格式)-可文件分析
        POST
    • 应用手册
      • 1. OpenClaw
      • 2. Chatbox
      • 3. IntelliJ IDEA(PyCharm)
      • 4. Cursor
      • 5. Trae
      • 6. CherryStudio
      • 7. Dify
      • 8. AingDesk
      • 9. VS Code
      • 10. Zed
      • 11. DeepChat
      • 12. Sider
      • 13. ChatWise
      • 14. Glarity
      • 15. WPS
    • 程序中如何使用
      • 1. Python
      • 2. nodejs

    用户使用常见问题解答手册

    一、接入与使用指南#

    Q1：什么是 API Key？为什么不能泄露？#

    API Key 是您调用模型接口的身份凭证，作用类似于密码。通过 API Key，平台可以识别您的身份、校验权限、统计用量并进行计费。
    为了保护您的账户安全，请注意：
    💡
    1.不要将 API Key 直接写在前端网页代码、公开仓库（如 GitHub）、截图或聊天记录中
    2.不要多人共用一个 API Key，建议按使用场景分别创建
    3.如果怀疑 API Key 已泄露，请立即登录 91model 控制台，删除或禁用旧 Key，重新创建一个新的
    4.建议将 API Key 保存在环境变量、服务端配置文件或密钥管理工具中，而不是硬编码在代码里

    Q2：什么是 API Base URL？#

    API Base URL 是客户端请求模型服务时使用的网关地址。无论您使用 WorkBuddy、Cherry Studio 还是自研程序，都需要填写正确的 Base URL。
    填写时请避免以下常见错误：
    📌
    1.把平台官网地址当成了 API 网关地址 —— 这两个是不同的
    2.漏掉了 /v1 等版本路径
    3.重复拼接了 /chat/completions，导致地址出现两次（如
    .../v1/chat/completions/v1/chat/completions）
    4.使用了模型官方的地址，而不是 91model 提供给您的网关地址
    5.地址末尾多出了空格、中文标点或错误的斜杠

    Q3：什么是模型 ID？为什么不能随便填写？#

    模型 ID 是接口识别具体模型的标识。每个模型在 91model 平台都有一个唯一的 ID，您需要在客户端中填写正确的模型 ID 才能调用对应的模型。
    以下是一些模型 ID 的示例：
    💡
    gpt-5.5
    deepseek-v4-pro
    qwen3.6-plus
    claude-opus-4-8
    gemini-3-pro-preview
    请注意：以上仅为示例，请以 91model 控制台「模型广场」或「模型列表」中显示的实际模型 ID 为准。如果您填写的模型 ID 与平台不匹配，通常会遇到以下错误：
    📌
    400 Bad Request
    404 Not Found
    422 Unprocessable Entity
    "Model not found"（模型未找到）
    “The model does not exist"（模型不存在）
    "You do not have access to this model"（您没有该模型的访问权限）

    Q4：如何在 WorkBuddy 或 Cherry Studio 中接入 91model？#

    workBuddy 配置步骤：
    💡
    1.点击对话框发送按钮左侧的模型名称
    2.选择「配置自定义模型」
    3.在提供商列表中下滑到底部，选择「其他」分类下的自定义选项
    4.填写 91model 提供给您的 API Base URL（接口地址）和 API Key，然后填写模型 ID
    5.根据需要选择高级功能配置，输入/输出参数建议使用默认值，点击保存
    6.保存后，在发送按钮左侧的模型菜单中选择刚配置的模型，即可正常使用
    Cherry Studio 配置步骤：
    📌
    1.点击右上角的齿轮图标，进入设置页面
    2.在模型配置页面点击「添加」按钮
    3.填写模型提供商名称（可自定义），然后输入 91model 的 API 密钥和 API 地址
    4.建议先点击「获取模型列表」自动拉取可用模型；如果获取失败，可手动添加模型 ID
    5.添加完成后，返回首页选择所需模型，即可开始使用

    Q5：WorkBuddy 配置后提示 401 Unauthorized 怎么办？#

    401 错误表示身份认证失败。请依次检查以下项目：
    📌
    1.确认 API Key 是否完整复制，前后是否多出了空格、换行或引号
    2.确认是否误填了其他平台的 API Key
    3.登录 91model 控制台，确认该 API Key 是否处于启用状态
    4.确认 Base URL 是否为 91model 提供给您的网关地址
    5.确认您的账户是否有该模型的使用权限
    如果以上都确认无误，建议在控制台重新创建一个新的 API Key，然后重新测试。

    Q6：WorkBuddy 中找不到已配置的模型怎么办？#

    如果配置完成后在模型列表中找不到模型，请尝试：
    💡
    1.确认模型配置是否已保存 —— 未保存的配置不会生效
    2.刷新 WorkBuddy 模型列表，或重启客户端
    3.登录 91model 控制台，核对模型 ID 是否拼写正确
    4.使用 Postman 或 Apifox 等工具直接调用 API 接口，验证 Key + 模型 ID 是否正常工作
    5.如果 API 调用正常但 WorkBuddy 中仍然找不到，可能是客户端兼容性问题，建议联系技术支持

    Q7：Cherry Studio 中「获取模型列表失败」怎么办？#

    获取模型列表失败不影响正常使用，您可以：
    💡
    1.不要依赖「自动获取模型列表」功能，直接手动添加模型 ID
    2.在 91model 控制台的模型广场中查看可用的模型 ID，手动填入 Cherry Studio
    3.使用 Postman 或 Apifox 直接测试聊天接口，确认 Key 和模型是否可用
    4.如果聊天功能正常，仅模型列表获取失败，通常是客户端的接口兼容性问题，不影响实际使用
    5.如果问题持续，可以记录请求地址、返回的状态码和错误信息，联系技术支持协助排查

    Q8：Cherry Studio 能看到模型，但发送消息后没有回复怎么办？#

    请按以下顺序排查：
    💡
    1.发送消息后，检查是否弹出了错误提示或状态码（如 401、403、429、500 等）
    2.登录 91model 控制台，确认账户余额是否充足
    3.确认填写的模型 ID 是否正确
    4.确认会话模式是否与模型能力匹配（例如不要用纯文本模式发送图片）
    5.如果开启了流式输出（Stream），确认客户端版本是否支持
    6.检查本地网络或代理是否正常
    7.使用 Postman 或 Apifox 用同样的 API Key 和模型 ID 进行测试，判断是接口问题还是客户端问题
    如果以上排查均无异常，请记录完整的错误信息和请求时间，联系技术支持。

    Q9：Cherry Studio 提示「模型不支持图片/文件/联网搜索」怎么办？#

    这个提示通常不是 API Key 或网关的问题，而是您选择的模型本身不支持这些功能。请确认：
    💡
    1.您当前使用的模型是否为多模态模型（支持图片输入）
    2.该模型是否支持文件解析功能
    3.该模型是否支持联网搜索功能
    4.您的账户是否已开通对应的高级能力

    二、其他常见问题#

    Q1：Opus 4.6/4.8 为什么没有触发缓存？#

    缓存触发与输入内容的长度有关。各模型触发缓存的最低输入 Token 要求如下：
    💡
    1.Opus 4.6 / Haiku 4.5：输入需大于 4,096 tokens
    2.Opus 4.8 / Sonnet 4.5：输入需大于 1,024 tokens
    3.Opus 4.7 / Haiku 3.5：输入需大于 2,048 tokens
    例如，如果您使用 Opus 4.6，需要保证单次请求的输入超过 4,096 tokens 才会触发缓存机制，从而降低重复调用的费用。

    Q2：从云主机访问 91model 出现 403/连接超时/TLS 握手失败怎么办？#

    问题原因：
    如果您使用的是国内云主机（如阿里云、腾讯云），从云主机访问 91model.ai 时可能遇到连接问题。这是因为国内云主机到境外服务器之间的跨境网络链路质量不稳定，并非您的账号或 API Key 有问题。
    典型表现：
    📌
    1.返回 403 Forbidden 或 Cloudflare 验证码
    2.连接超时 / TLS 握手失败
    3.同一个 API Key 从您本地的办公网络或家庭网络访问正常
    排查方法：
    💡
    1.先用您的本地电脑（非云主机）执行 curl 测试，确认接口本身正常
    2.再从云主机执行同样的 curl 测试，对比结果
    3.如果本地正常、云主机异常，基本可以确定是云主机跨境网络问题
    4.临时切换到手机热点或其他网络环境测试，进一步排除配置错误
    解决方案：
    📌
    1.短期：如果云主机支持，尝试使用直连方式（不经过 SD-WAN 加速）进行 API 调用
    2.长期：联系您的云服务商开通境外加速节点，或考虑使用境外服务器部署调用程序
    注意：排查时请使用您自己的 API Key 在本地测试，不要使用他人的 Key，避免消耗他人额度。

    Q3：Claude Desktop 版如何连接 91model API？#

    Claude Desktop 本身不支持直接配置第三方 API 地址，需要通过中转工具来实现。
    推荐方案：
    📌
    1.下载并安装 售后人员提供的 Claude 安装包
    2.下载 CC Switch 中转服务工具
    3.在 CC Switch 中配置 91model 提供的 API 网关信息（Base URL 和 API Key）
    4.配置完成后，Claude Desktop 即可通过中转服务使用 91model 的模型
    如果您需要详细的操作指导，请联系技术支持获取配置教程。

    Q4：调用 API 返回 HTTP 524 错误怎么办？#

    错误原因：
    HTTP 524 是 Cloudflare CDN 的超时错误。当您的请求处理时间超过您部署的 Cloudflare 服务的 125 秒上限时，Cloudflare 会主动断开连接并返回 524。简单来说，这个请求处理得太慢了。
    典型场景：
    您单次请求的输入内容很长、要求生成的内容也很多，或模型本身响应较慢，导致 125 秒内没有返回结果。
    解决方案：
    💡
    1.缩短单次请求的输入长度
    2.降低 输入token的值，减少输出量
    3.开启流式输出（stream: true），边生成边返回，避免超时
    4.对于超长内容，可以拆分成多个较短的请求分别处理
    5.如果业务确实需要长耗时处理，请联系技术支持沟通架构优化方案

    Q5：使用 Claude 模型时，模型自述的版本号与实际调用的不一致？#

    💡
    这是 Claude 模型的已知特性 —— 模型自我报告的版本号不一定与其实际版本一致，不能作为判断依据。
    您无需担心，系统实际调用的模型以您在请求中指定的模型 ID 为准。模型偶尔会错误地自报版本号，这不影响实际的调用效果和计费

    Q6：doubao-seedance-2.0 模型 POST 正常但 GET 请求报错 403#

    💡
    此问题已确认为已知 bug，目前已经修复。如果您仍然遇到此问题，请联系技术支持。

    Q7：Seedance系列模型的RPM和并发值的具体数值是多少？#

    图片1.png
    • RPM：账号下同一模型（按版本区分）每分钟允许创建的任务数量上限；超了会在创建任务时报错
    • 并发：同一模型同一时刻处于处理中的任务数上限
    修改于 2026-08-10 07:59:17
    上一页
    AI 网关常见 HTTP 错误码说明
    下一页
    前言-模型兼容性（必读）
    Built with