jiapx API 中转平台
一个统一的大模型 API 网关。通过兼容 OpenAI 与 Anthropic 的标准接口,用一个地址、一个密钥调用多个主流模型,并按实际用量计费。
接口地址 https://www.jiapx.xyz/v1 · 认证方式 Bearer Token · 支持对话补全、流式输出、模型列表等标准接口。
快速开始
三步即可发出第一个请求。
- 获取 API 令牌
登录控制台 www.jiapx.xyz,进入「令牌」页面创建新令牌并复制。令牌是一串约 48 位的字符串,请妥善保管。 - 确认接口地址与模型
接口地址为https://www.jiapx.xyz/v1,可用模型见下方模型列表。 - 发起调用
用下面的代码发起一次对话请求,替换成你自己的令牌即可。
curl https://www.jiapx.xyz/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-4-5",
"messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
}'
控制台复制的令牌直接原样使用,不要自行添加 sk- 前缀。请求格式为 Authorization: Bearer 你的令牌。
认证方式
所有接口均通过 HTTP 请求头鉴权。将控制台创建的令牌放在 Authorization 头中,以 Bearer 开头。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
| 参数 | 位置 | 说明 |
|---|---|---|
Authorization | Request Header | 值为 Bearer 令牌,令牌从控制台令牌页获取 |
Content-Type | Request Header | 固定为 application/json |
x-api-key | Request Header | 仅 Anthropic 接口可用,与 Bearer 二选一 |
令牌未携带、无效或额度耗尽时,接口返回 401 或 429 错误,详见错误码。
模型列表
当前平台已启用以下模型。调用时把 model 参数填成下表中的模型 ID(区分大小写)。
| 系列 | 模型 ID | 适用场景 |
|---|---|---|
| Claude Opus | claude-opus-4-7claude-opus-4-6 | 能力最强,适合复杂推理、长文本、高难度任务 |
| Claude Haiku | claude-haiku-4-5claude-haiku-4-5-20251001claude-haiku-5-5 | 速度快、成本低,适合日常对话和高并发场景 |
| Claude Fable | claude-fable-5claude-fable-5-1claude-fable-5-2 | Claude 系列模型,按需选用 |
| DeepSeek | DeepSeek-V4-Flash-0731 | DeepSeek 系列,速度快 |
| LongCat | LongCat-2.0 | 长猫系列模型 |
模型会随上游渠道调整而增减。程序化获取最新可用列表,请调用获取模型列表接口,或在控制台查看。
对话补全(OpenAI 兼容)
这是最通用的接口,兼容 OpenAI Chat Completions API。绝大多数第三方客户端和 SDK 都支持。
| 项目 | 值 |
|---|---|
| 请求方法 | POST |
| 完整地址 | https://www.jiapx.xyz/v1/chat/completions |
| 认证 | Authorization: Bearer YOUR_API_KEY |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,见模型列表 |
messages | array | 是 | 对话消息数组,每项含 role(system/user/assistant)与 content |
stream | boolean | 否 | 是否流式输出,默认 false |
temperature | number | 否 | 采样温度,越低越确定 |
max_tokens | number | 否 | 最大输出 token 数 |
top_p | number | 否 | 核采样参数 |
请求示例
curl https://www.jiapx.xyz/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-4-5",
"messages": [
{"role": "system", "content": "你是一个乐于助人的助手。"},
{"role": "user", "content": "用一句话解释什么是 API。"}
],
"temperature": 0.7
}'
响应示例
{
"id": "msg_01cGYN39RRzPuPAXpfR5qsTM",
"object": "chat.completion",
"created": 1795194738,
"model": "claude-haiku-4-5",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "API 是应用程序之间交互的接口。"},
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 15,
"total_tokens": 35
}
}
回复内容在 choices[0].message.content;usage 字段给出本次调用的输入、输出 token 用量。
消息接口(Anthropic 兼容)
平台同时提供 Anthropic Messages API 兼容接口,Claude Code 等原生使用 Anthropic 协议的工具可直接对接。
| 项目 | 值 |
|---|---|
| 请求方法 | POST |
| 完整地址 | https://www.jiapx.xyz/v1/messages |
| Base URL(工具填法) | https://www.jiapx.xyz |
| 认证 | x-api-key: YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY |
| 必需头 | anthropic-version: 2023-06-01 |
请求示例
curl https://www.jiapx.xyz/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'
响应示例
{
"id": "msg_01JTuXD8ff28Lk8KCAoXToyv",
"type": "message",
"role": "assistant",
"content": [{"type": "text", "text": "你好!有什么可以帮你?"}],
"stop_reason": "end_turn",
"model": "claude-haiku-4-5",
"usage": {"input_tokens": 11, "output_tokens": 9}
}
回复文本在 content[0].text。这就是 Claude Code 等工具使用的原生格式。
流式输出
设置 "stream": true 即可开启 SSE 流式返回,实现逐字输出效果。适用于聊天界面。
curl https://www.jiapx.xyz/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-4-5",
"messages": [{"role": "user", "content": "讲个故事"}],
"stream": true
}'
返回内容为一系列 data: {...} 事件,以 data: [DONE] 结束:
data: {"choices":[{"delta":{"content":"从"},"index":0}]}
data: {"choices":[{"delta":{"content":"前"},"index":0}]}
data: {"choices":[{"delta":{"content":"有"},"index":0}]}
...
data: [DONE]
客户端按 choices[0].delta.content 拼接增量文本即可。Anthropic 接口的流式格式类似,使用 content_block_delta 事件。
获取模型列表
用以下接口程序化获取当前可用模型,用于动态填充客户端的模型下拉框。
curl https://www.jiapx.xyz/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{"id": "claude-haiku-4-5", "object": "model", "owned_by": "openai"},
{"id": "claude-opus-4-6", "object": "model", "owned_by": "openai"}
]
}
返回 data 数组中每项的 id 即为可填入 model 参数的模型名。
错误码
错误以 JSON 格式返回,结构为 {"error": {"message": "...", "type": "..."}}。
| HTTP 状态 | 含义 | 处理建议 |
|---|---|---|
400 | 请求参数错误 | 检查 JSON 格式、必填字段与 model 名称 |
401 | 令牌无效或缺失 | 检查 Authorization 头,确认令牌正确且未加多余前缀 |
403 | 无权限访问 | 确认令牌权限与 IP 限制设置 |
404 | 接口或模型不存在 | 检查请求路径与模型 ID |
429 | 额度不足或请求过于频繁 | 充值或降低请求频率 |
500 / 502 | 服务端或上游错误 | 稍后重试,或更换模型 |
{
"error": {
"message": "无效的令牌",
"type": "new_api_error"
}
}
客户端配置
平台兼容 OpenAI / Anthropic 协议,几乎所有支持自定义接口的客户端都能接入。核心只需三样:接口地址、令牌、模型名。
WorkBuddy / 通用 OpenAI 兼容客户端
- 进入 头像 → 设置 → 模型 → 添加自定义模型 → 自定义 / Custom
- 接口地址(Base URL):
https://www.jiapx.xyz/v1 - API Key:控制台复制的令牌(原样,不加 sk- 前缀)
- 模型名称:
claude-haiku-4-5等 - 「自定义协议」开关保持关闭,让客户端自动补全
/chat/completions
Claude Code(Anthropic 协议)
通过环境变量配置:
export ANTHROPIC_BASE_URL="https://www.jiapx.xyz"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-haiku-4-5"
Cherry Studio / Lobe Chat / NextChat 等
- 接口地址:
https://www.jiapx.xyz/v1 - API Key:你的令牌
- 模型:从模型列表选择,或手动填入模型 ID
若工具要求填「完整地址」,则填 https://www.jiapx.xyz/v1/chat/completions。
连不通通常是三个原因:接口地址少了或多了 /v1、令牌填错、模型名拼错。用 curl 示例先验证通,再填到客户端。
SDK 示例
由于接口兼容 OpenAI 协议,可直接使用官方 SDK,只需替换 base_url 和 api_key。
Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://www.jiapx.xyz/v1",
)
resp = client.chat.completions.create(
model="claude-haiku-4-5",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
print("用量:", resp.usage)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://www.jiapx.xyz/v1",
});
const resp = await client.chat.completions.create({
model: "claude-haiku-4-5",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
计费与额度
调用按实际 token 用量计费,不同模型单价不同。每次响应都会在 usage 字段返回 token 消耗。
- 额度查询:在控制台「令牌」页查看剩余额度;部分部署支持通过
/v1/usages等接口查询。 - 用量明细:控制台「日志」页可查看每次请求的模型、token 数与扣费。
- 额度耗尽:返回
429错误,需充值或更换令牌。
令牌等同于账户凭证,请勿公开、提交到代码仓库或发给他人。泄露后请立即在控制台删除并重建。
常见问题
调用报「无效的令牌」怎么办?
确认:① 令牌从控制台令牌页复制、原样使用;② 不要加 sk- 或其他前缀;③ 请求头格式为 Authorization: Bearer 令牌;④ 令牌未被删除且状态为启用。
接口地址到底填 /v1 还是完整路径?
多数客户端的「Base URL」填 https://www.jiapx.xyz/v1,客户端会自动补 /chat/completions。若客户端要求填「完整接口地址」,则填 https://www.jiapx.xyz/v1/chat/completions。按工具提示选择,先用 curl 验证。
支持 Anthropic 协议吗?
支持。Anthropic 消息接口地址为 https://www.jiapx.xyz/v1/messages,Claude Code 等工具可直接使用。
模型名怎么区分大小写?
模型 ID 区分大小写,例如 DeepSeek-V4-Flash-0731 的大小写必须与实际一致。建议通过模型列表接口获取准确的 ID。
如何选择模型?
追求效果选 Opus 系列,追求速度和成本选 Haiku 系列。日常使用推荐 claude-haiku-4-5,平衡了速度与质量。