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

    新手入门

    本文面向第一次使用 Xmodel 的用户,说明从注册、充值、创建 Token 到完成 API 调用的完整流程。

    1.1 如何注册 Xmodel 并获得测试额度#

    平台定位#

    Xmodel 是一个 AI 主流模型 API 聚合平台,提供统一的 API 中转与管理能力。用户可以通过一套 Token 调用平台已开通的主流模型,也可以将同一个 Token 接入 Codex、Claude Code、Qoder、CC Switch 等客户端。
    平台入口:
    用途地址
    官网https://xmodel.pro
    控制台https://xmodel.pro/console
    钱包管理https://xmodel.pro/console/topup
    令牌管理https://xmodel.pro/console/token
    使用日志https://xmodel.pro/console/log
    模型与价格https://xmodel.pro/pricing
    官方文档https://doc.xmodel.pro
    API Base URLhttps://api.xmodel.chat/v1 或 https://api.xmodel.pro/v1

    注册与登录流程#

    1.
    打开 https://xmodel.pro。
    2.
    点击「控制台」进入登录/注册页面。
    3.
    按页面提示完成账号注册或登录。
    4.
    登录后进入控制台首页,确认页面能看到「数据看板」「令牌管理」「使用日志」「钱包管理」等菜单。
    5.
    如平台有新用户测试额度、活动额度或赠送余额,可在「钱包管理」「数据看板」或「系统公告」中查看。

    首次使用建议#

    第一次配置时,建议在「令牌管理」单独创建一个测试 Token,名称可填写「测试」「Codex」「Claude Code」或对应项目名称。
    不确定模型怎么选时,先在「模型与价格」里选择价格较低、响应稳定的模型跑通流程,再切换到更强模型。
    每个客户端、项目或成员建议单独创建 Token,便于后续在「使用日志」中统计消耗、定位问题和停用。
    不要把 Token 发送给他人,也不要直接写入公开仓库。

    1.2 如何购买 Token 额度与计费规则说明#

    充值与余额#

    进入「钱包管理」后,可查看账户余额、订阅套餐或进行额度充值。调用模型时,系统会根据实际请求消耗从账户余额中扣费。控制台首页也会展示当前余额、历史消耗、请求次数、统计 Token 数等信息。

    计费方式#

    Xmodel 的模型广场会展示不同模型的计费信息,常见字段如下:
    字段含义
    输入价格用户输入、上下文、提示词消耗的价格,通常按 1M Tokens 计费
    补全价格模型输出内容消耗的价格,通常按 1M Tokens 计费
    缓存读取价格命中缓存上下文时的读取价格
    缓存创建价格创建缓存上下文时产生的价格,部分模型支持
    模型价格图片等按次计费模型的单次调用价格
    按量计费按实际 Token 用量扣费
    按次计费按每次调用扣费,常见于图片生成模型
    倍率信息当前模型、分组或补全侧的计费倍率

    模型价格示例#

    模型广场当前可查看 OpenAI、Claude、图片生成等模型的价格,例如:
    模型计费说明
    gpt-5.4输入、补全、缓存读取按 1M Tokens 计费
    gpt-5.5输入、补全、缓存读取按 1M Tokens 计费
    gpt-image-2按次计费,适合图片生成场景
    claude-sonnet-5输入、补全、缓存读取按 1M Tokens 计费
    claude-fable-5支持输入、补全、缓存读取、缓存创建等价格项
    实际价格会随模型、活动分组和平台策略调整,请以「模型与价格」页面为准。

    成本控制建议#

    先用小额充值或现有余额跑通流程,确认客户端配置正确后再增加使用量。
    日常问答、简单代码修改优先选择性价比较高的模型。
    复杂推理、长上下文分析、图片任务再切换到更高阶或专用模型。
    批量任务、自动化任务建议单独创建 Token,并设置额度上限。
    经常查看「使用日志」和余额变化,发现异常消耗时及时停用对应 Token。

    1.3 如何获取与重置 API Key#

    在 Xmodel 中,API Key 通常以 Token/令牌形式管理。

    创建 Token#

    1.
    登录控制台。
    2.
    进入「令牌管理」。
    3.
    点击「添加令牌」。
    4.
    填写令牌名称,例如「测试」「Codex」「生产环境」。
    5.
    根据需要选择分组、过期时间、额度上限、模型限制列表和 IP 白名单。
    6.
    保存后复制 Token,用于客户端或 API 调用。

    Token 字段说明#

    字段建议填写方式
    名称写清用途,例如 Codex、Claude Code、测试、生产环境
    令牌分组不确定时保持默认;需要控制模型或倍率时再选择分组
    过期时间测试用可选较短时间,长期使用可选永不过期
    额度默认使用账户余额;需要限制风险时设置上限
    模型限制列表非必要不建议限制,除非只允许某些模型
    IP 白名单个人本地使用通常不填;生产环境可按网关策略配置

    令牌管理页面能力#

    「令牌管理」页面支持:
    添加令牌
    复制所选令牌
    删除所选令牌
    按名称或密钥查询
    启用/禁用令牌
    编辑令牌配置
    查看状态、剩余额度/总额度、分组、可用模型、IP 限制、创建时间、最后使用时间、过期时间

    重置或泄露处理#

    如 Token 泄露、被误提交到公开仓库,或怀疑异常消耗,应立即:
    1.
    进入「令牌管理」。
    2.
    找到对应 Token。
    3.
    先禁用或删除该 Token。
    4.
    重新添加一个新的 Token。
    5.
    更新客户端、服务端环境变量或配置文件中的 Token。
    6.
    到「使用日志」查看是否存在异常请求。

    1.4 仪表盘(Dashboard)功能全览#

    控制台首页即数据看板,主要用于查看账户、调用、消耗和服务状态。

    账户数据#

    当前余额:展示账户可用余额。
    充值入口:可跳转到钱包管理进行充值。
    历史消耗:展示累计消耗金额。

    使用统计#

    请求次数:统计接口请求数量。
    统计次数:展示平台统计口径下的调用次数。
    统计额度:展示已统计的消耗额度。
    统计 Tokens:展示累计 Token 消耗。

    性能指标#

    平均 RPM:平均每分钟请求数。
    平均 TPM:平均每分钟 Token 数。

    模型数据分析#

    数据看板提供多种图表视角:
    消耗分布
    调用趋势
    调用次数分布
    调用次数排行
    API Key 消耗排行
    API Key 消耗趋势
    这些图表适合用来判断哪个模型、哪个项目或哪个 Token 消耗较高。

    API 信息与公告#

    控制台会展示可用 API 地址、线路信息、测速/跳转入口、系统公告、常见问答和服务可用性信息。当前公告中提到平台域名为 https://xmodel.pro,API 地址可使用:
    https://api.xmodel.pro
    https://api.xmodel.chat

    1.5 API 快速调用#

    Xmodel 兼容 OpenAI API 格式。现有 OpenAI SDK 项目通常只需要替换 Base URL,并将 API Key 改为 Xmodel Token 即可。

    鉴权方式#

    所有 API 请求都需要在 Header 中携带:

    OpenAI 协议对话#

    接口:
    cURL 示例:
    返回示例:
    {
      "id": "chatcmpl-xxx",
      "object": "chat.completion",
      "choices": [
        {
          "message": {
            "role": "assistant",
            "content": "Hello"
          }
        }
      ]
    }

    Python SDK 示例#

    图片生成#

    接口:
    示例:
    图片生成建议优先使用英文提示词,可获得更稳定、更准确的画面效果。也可以先让 AI 优化提示词,再提交生成。

    查询模型列表#

    接口:
    示例:
    返回示例:
    {
      "object": "list",
      "data": [
        {
          "id": "gpt-5.5",
          "object": "model"
        }
      ]
    }

    1.6 常见问题排查#

    配置后客户端没有生效#

    检查 Base URL 是否填写为 https://api.xmodel.pro/v1 或 https://api.xmodel.chat/v1。
    检查 Token 是否复制完整。
    检查客户端是否需要重启或重新加载配置。
    到「使用日志」查看是否有请求进入。

    401 或 Invalid API Key#

    通常表示 Token 错误、Token 已禁用、Token 已删除或 Header 未正确携带 Authorization。

    404、模型不存在或 Model Not Found#

    检查模型名称是否与「模型与价格」或「列出模型」接口返回的模型 ID 一致。
    检查当前 Token 是否限制了可用模型。
    如使用客户端预设模型名,确认客户端配置没有写错。

    额度不足或请求被限制#

    到「钱包管理」查看余额。
    到「令牌管理」检查 Token 是否设置了额度上限。
    到「模型与价格」确认当前模型价格和倍率。

    如何知道是哪一个客户端在消耗额度#

    建议每个客户端或项目使用独立 Token,并在 Token 名称中写清用途。之后可在「使用日志」和「API Key 消耗排行」中定位消耗来源。
    上一页
    快速开始
    下一页
    开发者接入指南
    Built with