开发者文档
推理、账单与智能体验证文档
当前生产环境基地址为 https://www.xpersona.co。本页涵盖原生 OpenCode 接入、Xpersona /v1 推理、月度套餐与预付费额度、用量控制台、爬虫许可证与 feed 优先验证。
套餐
$20 / $100 / $200
固定月度容量，无意外超额账单
模型
16 个
真正的 GPT、Claude、Gemini 与 Xpersona 模型
默认模型
Claude Fable 5
OpenCode 与对话补全默认使用
接入
OpenAI 兼容
通过 /v1 与原生 OpenCode 路由
Base URL 与认证
Base URL（基地址）
所有请求使用同一基地址 https://www.xpersona.co。认证：使用你的 API Key 作为 Bearer Token。
GET /v1/models
公开端点，返回 Xpersona 的模型 ID 列表。
POST /v1/chat/completions
以 Bearer API Key 调用任意公开模型。
GET /v1/pricing
公开端点，返回零售模型价格卡片。
GET /v1/usage
以 Bearer API Key 访问账单、额度、消费与最近调用。
如何选择模型
cURL (对话补全（POST /v1/chat/completions）)
示例
curl -s "https://www.xpersona.co/v1/chat/completions" \
-H "Authorization: Bearer $XPERSONA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-fable-5","messages":[{"role":"user","content":"写一个最小可用的 Next.js 路由"}]}'JavaScript
示例
const res = await fetch("https://www.xpersona.co/v1/chat/completions", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.XPERSONA_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "claude-fable-5",
messages: [{ role: "user", content: "解释一下 OpenCode 如何做智能体工作" }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);Python
示例
from openai import OpenAI
client = OpenAI(
api_key=os.environ["XPERSONA_API_KEY"],
base_url="https://www.xpersona.co/v1",
)
response = client.chat.completions.create(
model="claude-fable-5",
messages=[{"role": "user", "content": "写一个示例"}],
)
print(response.choices[0].message.content)错误与用量指导
• 401：请检查 API Key 是否正确，并确保已登录。
• 402：余额或套餐额度不足，请充值预付费额度或升级套餐。
• 429：请求过于频繁或已达额度上限，请稍后重试或降低并发。
用量控制台会在每个请求后更新 Token 与消费。
进阶内容请参阅英文文档
本页为中文快速上手。爬虫许可证、feed 优先验证、完整端点清单等高级内容请参阅 英文文档。
账单以 USD（美元）结算。可用的支付方式由实时结账流程决定；Xpersona 无法保证所有中国大陆银行卡均可支付，也不提供支付宝或微信支付的专属按钮。若支付失败，请更换支付方式或联系支持。