使用文档

所有接入细节、计费规则、常见问题都在这一页。看完即可上手。

快速开始

1. 登录控制台 → 「API 密钥」→ 新建密钥（密钥只在创建时显示一次）。

2. 把 Base URL 和 Key 填进任意 OpenAI 兼容工具：

curl https://x-api.me/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{ "model": "deepseek-v4.1-flash", "messages": [{"role":"user","content":"你好"}] }'

上面用的是免费试用模型 deepseek-v4.1-flash，注册即可直接跑通；其他模型把 model 换成广场里的名字即可。

3. Python / Node SDK：把 base_url 指向 https://x-api.me/v1，api_key 填你的密钥。

两个 Base URL 都可用，按需选：
· https://x-api.me/v1 —— 明文 HTTP，任何网络都能连（推荐先用它跑通）
· https://xapi.39-96-89-109.sslip.io/v1 —— TLS 加密，适合在公网/咖啡馆等环境传密钥
注意：证书只签发了 sslip.io 这个域名，直接访问 https://39.96.89.109 会提示证书不匹配，请用上面两个地址之一。

模型与倍率

全部可用模型见模型广场，均为当前渠道真实可用模型。计费公式：

实际费用 = 官方价（$ / 1M token）× 本站倍率 × token 数

各模型的实际单价（输入/输出，$/1M token）与"相当于官方几折"在模型广场逐条标注。本站充值为人民币，余额按 1 元 = 1 余额 显示，倍率列已按汇率折算（1 USD ≈ 7.1 CNY）。

思考型模型提示：免费试用的 deepseek-v4.1-flash / hy3 / step-5-preview 以及带 -thinking 后缀的模型会先输出思考过程再给答案。如果你把 max_tokens 设得很小（例如 16、32），额度会被思考过程吃掉，返回的 content 可能是空字符串（finish_reason=length），这不是接口故障。测速或一句话问答时请不要传 max_tokens，或把它设为 512 以上。

计费规则

举例 gpt-6.1-sol：官方价 $2（输入）/ $10（输出）每 1M token，本站倍率 0.0359x
→ 你的价格 = $0.072 / 1M 输入，$0.359 / 1M 输出
→ 一次请求用了 10,000 输入 + 2,000 输出 token：
   10,000/1M × $0.072 + 2,000/1M × $0.359 = $0.0014（约 1.4 分钱）
→ 余额 $10 可以跑约 7,000 次这样的请求

按 token 计费，输入/输出分开计算，输出部分按补全倍率放大
用量在「使用日志」逐笔可查，含模型、token 数、耗时、费用
额度用尽后调用会被拒绝，充值后立即恢复
密钥支持设置额度上限、模型白名单、过期时间

工具接入

工具	接入方式
Claude Code	ANTHROPIC_BASE_URL=https://x-api.me ANTHROPIC_AUTH_TOKEN=sk-你的密钥
Codex CLI	base_url = https://x-api.me/v1
Cursor / Cline / Roo Code	OpenAI 自定义 Base URL
Cherry Studio / LobeChat / Chatbox	OpenAI 兼容 provider
Dify / FastGPT	OpenAI-APICompatible 渠道

充值

每日签到：控制台侧边栏「奖励计划」，每天签到随机领 $1–5 免费额度（每账号每日一次）
兑换码：向管理员购买兑换码，在控制台「钱包」页兑换到账
扫码充值：微信/支付宝扫码自助充值正在接入中，上线后在本页公告

控制台「钱包」可查看余额与消耗曲线。

多语言调用示例

所有示例都把 base_url 指向 https://x-api.me/v1（OpenAI 官方 SDK 无需改其他代码）。

Python（openai 官方 SDK）

from openai import OpenAI
client = OpenAI(base_url="https://x-api.me/v1", api_key="sk-你的密钥")
r = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)

Node.js（openai 官方 SDK）

import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://x-api.me/v1", apiKey: "sk-你的密钥" });
const r = await client.chat.completions.create({
  model: "gpt-6.1-sol", messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

流式输出（SSE）

curl https://x-api.me/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","stream":true,"messages":[{"role":"user","content":"你好"}]}'

能力支持

能力	支持情况	说明
Chat Completions	✅ 全部模型	标准 OpenAI 协议
流式 stream	✅ 全部模型	SSE 格式，工具默认使用
Function Calling / tools	✅ 主流文本模型	OpenAI tools 格式，实测可用
Anthropic 协议	✅ /v1/messages	Claude Code、Anthropic SDK 直连
图片输入（vision）	⚠️ 部分模型	以模型广场标注为准
生图	✅ gpt-image-2	按张计费，见模型广场
Responses API	❌ 暂不支持	请使用 Chat Completions

错误码说明

状态码	含义	处理方式
401	密钥无效 / 已删除 / 被禁用	到控制台「API 密钥」确认状态，或重新创建
402	余额不足	到「钱包」充值或输入兑换码
403	模型未授权给该密钥	检查密钥的模型白名单设置
404	模型不存在	只能用模型广场列出的模型名
429	限流 / 上游繁忙	等待 1-3 秒重试；持续出现请查看状态页
500 / 502 / 503	上游渠道异常	会自动切换备用渠道重试；持续失败请稍后再试

每个错误响应都带 request id，反馈问题时请附上它。

从其他服务迁移

原配置	改成本站
`https://api.openai.com/v1`	`https://x-api.me/v1`
OpenAI API Key	本站控制台创建的 `sk-` 密钥
其他中转站的 Base URL	同上（通常只需换地址和 Key）

Claude Code 用户：设置 ANTHROPIC_BASE_URL=https://x-api.me 与 ANTHROPIC_AUTH_TOKEN=sk-你的密钥，无需其他改动。

常见问题

调用报 429 / 限流？

上游账号池有速率保护，稍等几秒重试即可；持续 429 说明上游抖动，可在状态页确认。免费试用模型（deepseek-v4.1-flash / hy3 / step-5-preview）是共享池，白天高峰更容易被限流，急用建议改用付费模型（注册赠送的 $1 足够跑很多次）。

模型名报错 not found？

只能调用模型广场列出的模型名，注意带日期后缀的版本（如 claude-opus-4-5-20251101）与不带后缀的别名是两个名字。

回复质量和官方不一样？

本站渠道均为逆向/池化上游，极端情况下上游可能降级。如发现明显异常，请带请求 ID 反馈给管理员。

密钥泄露了怎么办？

立即在控制台「API 密钥」中删除该密钥并新建。密钥可随时禁用/删除，删除后立即失效。

支持流式输出吗？

支持。所有模型均支持 stream: true，Claude Code / Codex 等工具默认走流式。