jiapx API 中转平台

一个统一的大模型 API 网关。通过兼容 OpenAI 与 Anthropic 的标准接口,用一个地址、一个密钥调用多个主流模型,并按实际用量计费。

● OpenAI 兼容 ● Anthropic 兼容 ● 按量计费 ● 多模型聚合
核心信息一览

接口地址 https://www.jiapx.xyz/v1 · 认证方式 Bearer Token · 支持对话补全、流式输出、模型列表等标准接口。

🔗
统一入口所有模型走同一个 Base URL,切换模型只改一个参数。
🔐
密钥鉴权控制台创建令牌,请求头带 Bearer Token 即可调用。
⚡
流式支持原生支持 SSE 流式输出,适配各类聊天客户端。
💰
用量透明每次请求返回 token 用量,控制台可查消费明细。

快速开始

三步即可发出第一个请求。

  1. 获取 API 令牌
    登录控制台 www.jiapx.xyz,进入「令牌」页面创建新令牌并复制。令牌是一串约 48 位的字符串,请妥善保管。
  2. 确认接口地址与模型
    接口地址为 https://www.jiapx.xyz/v1,可用模型见下方模型列表。
  3. 发起调用
    用下面的代码发起一次对话请求,替换成你自己的令牌即可。
curl
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 开头。

HTTP Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
参数位置说明
AuthorizationRequest Header值为 Bearer 令牌,令牌从控制台令牌页获取
Content-TypeRequest Header固定为 application/json
x-api-keyRequest Header仅 Anthropic 接口可用,与 Bearer 二选一

令牌未携带、无效或额度耗尽时,接口返回 401 或 429 错误,详见错误码。

模型列表

当前平台已启用以下模型。调用时把 model 参数填成下表中的模型 ID(区分大小写)。

claude-opus-4-7 claude-opus-4-6 claude-haiku-4-5 claude-haiku-4-5-20251001 claude-haiku-5-5 claude-fable-5 claude-fable-5-1 claude-fable-5-2 DeepSeek-V4-Flash-0731 LongCat-2.0
系列模型 ID适用场景
Claude Opusclaude-opus-4-7
claude-opus-4-6
能力最强,适合复杂推理、长文本、高难度任务
Claude Haikuclaude-haiku-4-5
claude-haiku-4-5-20251001
claude-haiku-5-5
速度快、成本低,适合日常对话和高并发场景
Claude Fableclaude-fable-5
claude-fable-5-1
claude-fable-5-2
Claude 系列模型,按需选用
DeepSeekDeepSeek-V4-Flash-0731DeepSeek 系列,速度快
LongCatLongCat-2.0长猫系列模型
以实际为准

模型会随上游渠道调整而增减。程序化获取最新可用列表,请调用获取模型列表接口,或在控制台查看。

对话补全(OpenAI 兼容)

这是最通用的接口,兼容 OpenAI Chat Completions API。绝大多数第三方客户端和 SDK 都支持。

项目值
请求方法POST
完整地址https://www.jiapx.xyz/v1/chat/completions
认证Authorization: Bearer YOUR_API_KEY

请求参数

参数类型必填说明
modelstring是模型 ID,见模型列表
messagesarray是对话消息数组,每项含 role(system/user/assistant)与 content
streamboolean否是否流式输出,默认 false
temperaturenumber否采样温度,越低越确定
max_tokensnumber否最大输出 token 数
top_pnumber否核采样参数

请求示例

curl
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
  }'

响应示例

JSON
{
  "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
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": "你好"}]
  }'

响应示例

JSON
{
  "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 · OpenAI 格式
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] 结束:

SSE 数据流
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
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 协议)

通过环境变量配置:

bash
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

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

javascript
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,平衡了速度与质量。