JetAPI / OpenAI 兼容接口

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/completionsPOST标准对话补全,最常用
/v1/responsesPOSTOpenAI Responses 协议,Codex 系模型使用
/v1/messagesPOSTAnthropic Messages 协议,Claude Code 使用
/v1/images/generationsPOST图像生成
/v1/modelsGET拉取当前可用模型清单

三、请求示例

先看一个容易踩的坑

如果不小心漏掉 /v1,服务端不会返回 404,而是返回 200 加一段 HTML。实测:

请求HTTPContent-Type实际内容
POST /v1/chat/completions401application/json真实 API 端点(缺 Key 时 401)
POST /chat/completions200text/html站点的单页应用入口,不是 JSON
GET /v1/models401application/json真实 API 端点
GET /models200text/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"])
)
参数可选值
modelgpt-image-2.6、gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5 系列
size1024x1024、1024x1536、1536x1024
n1-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错误内容含义
400invalid_request_error请求体格式错误或缺少必填参数
401Invalid tokenKey 无效、被禁用或格式错误
403用户额度不足余额 ≤ 0
404not_found路径错误。注意:路径少写 /v1 时不一定报 404,可能返回 200 + HTML(见第三节)
405Method Not AllowedAnthropic 端点(/v1/messages)少了 /v1;或 Base URL 带了多余路径
429rate_limit_exceeded超过并发或速率限制
500upstream_error上游返回异常
503无可用渠道该模型当前没有可用上游,可换模型或稍后重试

九、相关页面