概述与快速开始

这份文档介绍如何在 路梦云图 创建 API Key、选择分组、配置 Claude Code / Codex / Gemini CLI 等客户端、查询用量，以及排查常见接入错误。

项目	值	说明
Base URL	https://xmlumen.org	Claude Code / Gemini CLI 填根地址；OpenAI 兼容工具填 https://xmlumen.org/v1
认证方式	Bearer Token 或 x-api-key	使用控制台创建的 API Key，不要填写上游官方 Key
推荐流程	Key → 分组 → 客户端 → 测试	先确认 Key 的分组与可用模型，再接入客户端

快速开始

第一次接入建议按下面的顺序操作，可以避免绝大部分认证、分组和模型不可用的问题。

1. 注册并登录控制台 —— 进入 路梦云图 控制台，确认账户余额、订阅或管理员分配的可用额度。
2. 创建 API Key —— 在 API 密钥页面 新建 Key。创建时选择的分组决定了这个 Key 走哪个平台（Claude / OpenAI / Gemini / Grok）、可以用哪些模型和倍率，请按用途选择。
3. 配置客户端 —— 按 客户端配置 接入 Claude Code、Codex、Gemini CLI 或其他 OpenAI 兼容客户端。也可以在 API 密钥列表点击 Key 的「使用密钥」，直接复制已填好 Key 的配置。
4. 发送测试请求 —— 用下面的示例确认认证、模型名、额度和网络都正常。

测试请求

Claude 协议分组

curl https://xmlumen.org/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

OpenAI 兼容

curl https://xmlumen.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [{"role": "user", "content": "你好"}]
  }'

TIP

示例中的模型名仅供参考。实际可用的模型取决于 Key 所在分组，请以 模型与用量 的查询结果为准。新一代 Claude 模型默认开启思考，max_tokens 不要设得太小，否则可能还没输出正文就达到上限。

接口地址

平台会把请求自动路由到后台配置的上游账号，用户侧只需要使用统一地址。不同协议的入口如下：

用途	地址	说明
Claude（Anthropic Messages）	https://xmlumen.org/v1/messages	Claude Code、Anthropic SDK 使用；Base URL 填根地址
OpenAI Chat Completions	https://xmlumen.org/v1/chat/completions	Cherry Studio、NextChat、OpenAI SDK 等通用客户端使用
OpenAI Responses（Codex）	https://xmlumen.org/v1/responses	Codex CLI 使用，wire_api 为 responses
Gemini 原生接口	https://xmlumen.org/v1beta	Gemini CLI / Google SDK 使用；Base URL 填根地址
模型列表	GET https://xmlumen.org/v1/models	查询当前 Key 可用的模型
控制台	https://xmlumen.org/	创建 Key、查看用量、管理账户
按 Key 查用量	https://xmlumen.org/key-usage	输入 Key 即可查询用量，无需登录

Antigravity 专用通道

如果站点开通了 Antigravity 专用通道，Claude Code 可将 Base URL 换成 https://xmlumen.org/antigravity，其余配置不变。是否开通以管理员公告为准。