JetAPI OpenAI 兼容接口说明
JetAPI 提供的 OpenAI 兼容端点 base_url 为 https://api.jetapi.icu/v1,
鉴权使用标准 Authorization: Bearer <KEY> 头。支持
/chat/completions、/responses、/images/generations、
/models 四类端点,并另外提供 Anthropic 原生的 /v1/messages。
任意 OpenAI 官方 SDK 只需替换 base_url 与 api_key 即可工作。
一、基础信息
| 项目 | 值 |
|---|---|
| Base URL(OpenAI 协议) | https://api.jetapi.icu/v1 |
| Base URL(Anthropic 协议) | https://api.jetapi.icu(不带 /v1) |
| 鉴权头 | Authorization: Bearer sk-xxx |
| Anthropic 鉴权头 | x-api-key: sk-xxx + anthropic-version: 2023-06-01 |
| 内容类型 | application/json |
| 流式响应 | 支持("stream": true) |
二、支持的端点
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions | POST | 标准对话补全,最常用 |
/v1/responses | POST | OpenAI Responses 协议,Codex 系模型使用 |
/v1/messages | POST | Anthropic Messages 协议,Claude Code 使用 |
/v1/images/generations | POST | 图像生成 |
/v1/models | GET | 拉取当前可用模型清单 |
三、请求示例
先看一个容易踩的坑
如果不小心漏掉 /v1,服务端不会返回 404,而是返回 200 加一段 HTML。实测:
| 请求 | HTTP | Content-Type | 实际内容 |
|---|---|---|---|
POST /v1/chat/completions | 401 | application/json | 真实 API 端点(缺 Key 时 401) |
POST /chat/completions | 200 | text/html | 站点的单页应用入口,不是 JSON |
GET /v1/models | 401 | application/json | 真实 API 端点 |
GET /models | 200 | text/html | 同样是 HTML |
为什么这比 404 更难排查:拿到 404 你会立刻知道路径错了;
拿到 200 加 HTML,客户端通常会在「解析 JSON 失败」或「Unexpected token <」这一步报错,
看起来像 SDK 问题,实际是 Base URL 少了一段路径。
遇到 JSON 解析错误,先打印原始响应体确认是不是 HTML。
对话补全
curl https://api.jetapi.icu/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{"role": "system", "content": "你是一个简洁的助手"},
{"role": "user", "content": "用一句话解释什么是 REST"}
],
"temperature": 0.7,
"max_tokens": 200
}'
响应结构遵循 OpenAI 规范:
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1734567890,
"model": "gpt-6.1-sol",
"choices": [
{
"index": 0,
"message": {"role": "assistant", "content": "REST 是一种..."},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 32,
"completion_tokens": 48,
"total_tokens": 80
}
}
流式输出
curl https://api.jetapi.icu/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [{"role": "user", "content": "数到 5"}],
"stream": true
}'
返回 SSE 流,每行以 data: 开头,最后一行是 data: [DONE]。
Python SDK
from openai import OpenAI
client = OpenAI(
base_url="https://api.jetapi.icu/v1",
api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Node.js SDK
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://api.jetapi.icu/v1',
apiKey: 'sk-你的密钥',
})
const resp = await client.chat.completions.create({
model: 'gpt-6.1-sol',
messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)
四、Anthropic 协议示例
Claude Code 走这个端点。注意 base_url 不带 /v1:
curl https://api.jetapi.icu/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 100,
"messages": [{"role": "user", "content": "你好"}]
}'
五、图像生成
curl https://api.jetapi.icu/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6",
"prompt": "a red apple on white marble, soft daylight",
"n": 1,
"size": "1024x1024"
}'
返回 b64_json,需要自己解码保存:
import base64, pathlib
pathlib.Path("out.png").write_bytes(
base64.b64decode(resp["data"][0]["b64_json"])
)
| 参数 | 可选值 |
|---|---|
model | gpt-image-2.6、gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5 系列 |
size | 1024x1024、1024x1536、1536x1024 |
n | 1-4 |
计费:每张 $0.012,与提示词长度无关。
六、拉取可用模型
curl https://api.jetapi.icu/v1/models \
-H "Authorization: Bearer sk-你的密钥"
返回的清单由你的 Key 所属分组的权限决定。同一个账号下不同分组的 Key,看到的模型列表可能不同。
七、与官方 OpenAI 的差异
| 项目 | 差异 |
|---|---|
| 模型名 | 部分模型沿用上游命名(如 gpt-image-2.6 而非官方的 gpt-image-1)。接入前请用 /v1/models 确认。 |
| Codex 通道固定前置 | 约 4400 tokens 的 system prompt 会被注入,其中约 95% 命中缓存(按 1/10 价计费)。短请求名义单价偏高。 |
| 余额为负 | 预扣 + 结算机制下,长上下文请求可能使余额短暂为负。下一次请求会被拒绝,不会持续透支。 |
| 并发限制 | 不同分组有不同并发上限,超过会返回 429。具体数值以控制台显示为准。 |
| 可用性 | 不提供 SLA 承诺。关键业务建议自建多线路容灾。 |
八、错误码
| HTTP | 错误内容 | 含义 |
|---|---|---|
| 400 | invalid_request_error | 请求体格式错误或缺少必填参数 |
| 401 | Invalid token | Key 无效、被禁用或格式错误 |
| 403 | 用户额度不足 | 余额 ≤ 0 |
| 404 | not_found | 路径错误。注意:路径少写 /v1 时不一定报 404,可能返回 200 + HTML(见第三节) |
| 405 | Method Not Allowed | Anthropic 端点(/v1/messages)少了 /v1;或 Base URL 带了多余路径 |
| 429 | rate_limit_exceeded | 超过并发或速率限制 |
| 500 | upstream_error | 上游返回异常 |
| 503 | 无可用渠道 | 该模型当前没有可用上游,可换模型或稍后重试 |