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

    新手入门

    本文面向第一次使用 Xmodel 的用户,帮助您完成注册、充值、创建 Token、查看控制台和发起第一次 API 调用。
    ⚠️ 注意:文档中的 API Key / Token 均使用占位符示例,请勿把真实密钥粘贴到公开文档、截图、GitHub 仓库或前端页面中。

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

    平台入口#

    用途地址
    官网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
    API Base URLhttps://api.xmodel.pro/v1 或 https://api.xmodel.pro/v1

    注册步骤#

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

    新手建议#

    第一次使用时,建议先创建一个名为 test 或 测试 的 Token。
    不确定模型怎么选时,先用价格较低、响应稳定的模型跑通流程。
    每个客户端或项目建议单独创建 Token,方便后续统计消耗。

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

    充值与余额#

    进入 钱包管理 后,可以查看当前余额、历史消耗、充值记录或套餐信息。模型调用会根据实际请求消耗从账户余额中扣费。

    计费字段说明#

    字段含义
    输入价格用户输入、上下文、提示词消耗的价格
    补全价格模型输出内容消耗的价格
    缓存读取价格命中缓存上下文时的读取价格
    缓存创建价格创建缓存上下文时产生的价格,部分模型支持
    按量计费按实际 Token 用量扣费
    按次计费常见于图片生成、图片编辑等模型
    倍率信息当前模型、分组或补全侧的计费倍率

    成本控制建议#

    1.
    先用小额充值或测试额度跑通流程。
    2.
    日常问答优先选择性价比模型。
    3.
    复杂推理、长上下文、图片生成再切换到高阶模型。
    4.
    批量任务建议单独创建 Token,并设置额度上限。
    5.
    定期查看 使用日志 和 API Key 消耗排行。

    1.3 如何获取与重置 API Key#

    创建 Token#

    1.
    登录 Xmodel 控制台。
    2.
    进入 令牌管理。
    3.
    点击 添加令牌。
    4.
    填写令牌名称,例如 Codex、Cursor、生产服务。
    5.
    按需配置 额度上限、模型限制、IP 白名单。
    6.
    保存后复制 Token。

    Token 使用示例#

    Token 泄露后如何处理#

    1.
    进入 令牌管理。
    2.
    找到泄露的 Token。
    3.
    先点击 禁用 或 删除。
    4.
    重新创建新 Token。
    5.
    更新客户端或服务器中的环境变量。
    6.
    到 使用日志 检查是否存在异常调用。
    ⚠️ 注意:已经泄露的 Token 不建议继续使用。

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

    账户数据#

    数据看板 会展示当前余额、历史消耗、请求次数、Token 消耗、平均 RPM、平均 TPM 等信息。

    模型数据分析#

    常见图表包括 消耗分布、调用趋势、调用次数分布、调用次数排行、API Key 消耗排行、API Key 消耗趋势。

    API 信息与公告#

    控制台会展示可用 API 地址、线路信息、测速入口、系统公告和常见问答。生产业务建议定期查看系统公告,避免错过域名、模型、价格或线路变化。

    1.5 API 快速调用#

    鉴权方式#

    cURL 调用示例#

    Python 调用示例#

    1.6 常见问题排查#

    配置后客户端没有生效#

    先完整退出客户端或终端,再重新打开。如果 使用日志 中完全没有请求记录,通常说明请求没有发到 Xmodel。

    401 或 Invalid API Key#

    通常是 Token 错误、Token 已禁用,或请求头没有正确携带 Authorization。

    404 或 Model Not Found#

    通常是 模型 ID 填写错误,或当前 Token 不允许调用该模型。

    技术支持与社群#

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