Xmodel
    • 快速开始
    • 新手入门
    • 开发者接入指南
    • 常见问题
    • 平台规则与支持
    • 客户端接入
      • CC Switch（小白用）
      • Claude Code 接入
      • Codex 接入
      • Codex + Image2
      • Qoder 接入
    • 账号与计费
      • 账号、额度与 Token
      • 模型与价格
    • API 接口参考
      • AI 模型接口
        • 对话
          • OpenAi协议对话
          • Anthropic 协议对话
          • Gemini协议对话
          • Codex 协议对话
        • 图片
          • 生成图片
          • 编辑图片
        • 模型信息
          • 列出模型
          • 列出 Gemini 模型

    常见问题

    常见问题解答#

    本文采用“场景化提问 + 结构化解答”的方式，帮助您快速定位 Xmodel 使用中的常见问题。

    3.1 账号与财务类#

    Q：充值后一直没到账怎么办？#

    A：通常是页面未刷新、支付订单仍在处理，或充值到了其他账号。
    1.
    进入 钱包管理 查看余额是否刷新。
    2.
    刷新控制台，或退出后重新登录。
    3.
    检查支付订单是否成功扣款。
    4.
    如果仍未到账，联系平台支持，并提供订单号、支付时间和充值金额。
    延伸阅读：账号、额度与 Token

    Q：余额为什么消耗得比我预期快？#

    A：通常是因为上下文太长、模型价格较高、自动重试或多个客户端共用同一个 Token。
    1.
    进入 使用日志 查看最近请求。
    2.
    进入 模型与价格 确认当前模型价格。
    3.
    检查是否有批量脚本、Agent 或客户端在循环调用。
    4.
    建议每个项目单独创建 Token，方便定位消耗来源。
    延伸阅读：模型与价格

    Q：发票应该怎么申请？#

    A：如平台当前支持发票或对账，一般需要通过 钱包管理 或联系平台支持处理。
    1.
    准备订单号、开票金额、发票抬头、税号和联系方式。
    2.
    检查控制台是否有发票或财务入口。
    3.
    如无自助入口，联系平台支持提交开票信息。
    延伸阅读：平台规则与支持

    3.2 技术与接口类#

    Q：为什么我的 Cursor 一直提示 401 Unauthorized？#

    A：通常是因为 API Key 填写错误、Token 已失效，或请求头鉴权格式不正确。
    1.
    确认填写的是 Xmodel 令牌管理 中复制的 Token。
    2.
    检查 Token 前后是否多了空格、换行或引号。
    3.
    确认 Token 没有被禁用或删除。
    4.
    如果是代码调用，请确认请求头为：
    延伸阅读：开发者接入指南

    Q：为什么提示 Rate Limit？#

    A：通常是请求频率过高，超过当前模型、Token、账号或上游渠道限制。
    1.
    降低并发请求数量。
    2.
    为失败重试增加等待时间。
    3.
    检查 数据看板 中的 RPM、TPM 指标。
    4.
    如为批量任务，建议排队执行或切换备用模型。
    延伸阅读：常见报错代码与排查指南

    Q：上下文长度怎么算？#

    A：上下文长度包括系统提示词、用户输入、历史消息、工具结果、上传内容和模型输出预留空间。
    1.
    删除无关历史消息。
    2.
    长文档先摘要再提问。
    3.
    批量任务拆成多个小请求。
    4.
    必要时选择支持更长上下文的模型。
    延伸阅读：模型与价格

    Q：为什么模型列表获取失败？#

    A：通常是 Base URL、Token 或客户端自动拉取模型列表的方式不兼容。
    1.
    确认 Base URL 为 **https://api.xmodel.pro/v1**。
    2.
    确认 Token 有效。
    3.
    如果客户端自动拉取失败，可以先手动填写模型 ID。
    4.
    使用 cURL 测试模型列表接口：
    延伸阅读：列出模型

    3.3 模型与路由类#

    Q：智能路由是怎么分配模型的？#

    A：智能路由会根据模型可用性、渠道负载、限流状态、分组策略和备用线路，将请求分配到更合适的上游渠道。
    1.
    用户仍然按 Model ID 发起请求。
    2.
    平台可能在后端选择更稳定的渠道。
    3.
    主渠道异常时，可能触发备用渠道或 Fallback。
    4.
    不同渠道的响应速度和策略可能略有差异。
    延伸阅读：平台能力

    Q：为什么同一个 Prompt 多次结果不一样？#

    A：大模型本身具有随机性，尤其在 temperature 较高时，结果可能不同。
    1.
    降低 temperature。
    2.
    明确输出格式。
    3.
    给出示例。
    4.
    固定模型 ID。
    延伸阅读：OpenAI 协议对话

    Q：图片生成为什么建议用英文提示词？#

    A：图片模型通常对英文提示词更稳定，尤其是风格、构图、材质、镜头和光线描述。
    1.
    先用中文写清楚需求。
    2.
    让文本模型改写成英文 Prompt。
    3.
    再调用图片生成接口。
    4.
    如果结果不稳定，补充风格、比例、主体、背景和细节限制。
    延伸阅读：生成图片

    技术支持与社群#

    💡 没找到答案？加入官方社群获取 1V1 支持
    如果您在接入或推广过程中遇到任何技术问题，欢迎加入 Xmodel用户交流群。我们的技术专家和运营团队将在群内为您提供快速解答。
    0f8842ac51f8d101c890c55e1d52a64e.jpg
    ⚠️ 注意：请备注 “您的公司/职业”。
    上一页
    开发者接入指南
    下一页
    平台规则与支持
    Built with