一个入口，连接你的
所有大模型。

快速开始

只需 API Key、Base URL 和模型名三项信息，即可完成第一次调用。

curl __BASE__/v1/chat/completions \
  -H "Authorization: Bearer gw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

from openai import OpenAI

client = OpenAI(
    api_key="gw_your_api_key",
    base_url="__BASE__/v1",
)

response = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "gw_your_api_key",
  baseURL: "__BASE__/v1",
});

const response = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);

curl __BASE__/v1/messages \
  -H "x-api-key: gw_your_api_key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

客户端配置

在支持自定义 API 服务的客户端中，按协议填写下面四项即可。模型名可通过 GET /v1/models 获取。

身份验证

无需注册账号。每个请求使用已发放的 API Key 验证身份，并关联对应套餐与使用记录。

获取可用模型

GET /v1/models 返回当前 API Key 可以使用的模型列表。

curl __BASE__/v1/models \
  -H "Authorization: Bearer gw_your_api_key"

请求时请使用返回结果中的模型 id。如果客户端不能自动加载模型，也可以手动填写该名称。

Chat Completions

兼容常用的 model、messages、max_tokens、temperature 和 stream 参数。

需要逐字输出时将 stream 设置为 true。请求完成后可在用户面板查看 Token 与费用记录。

Responses API

适用于使用 OpenAI Responses API 的客户端。模型权限、套餐额度、RPM、TPM 和最大输出限制同样生效。

curl __BASE__/v1/responses \
  -H "Authorization: Bearer gw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model","input":"用一句话解释 API 网关"}'

Anthropic Messages

使用 Anthropic 协议时请填写网关根地址，不要额外重复拼接 /v1。请求必须包含 x-api-key，客户端提供的 anthropic-version 会被转发。

ANTHROPIC_BASE_URL=__BASE__
ANTHROPIC_AUTH_TOKEN=gw_your_api_key

缓存读取和缓存创建产生的 Token 会计入使用记录，并按对应模型价格结算。

套餐额度

套餐不为每个模型分配固定 Token 数，而是提供统一的 $ 额度池。不同模型通过各自的输入价和输出价消耗同一份额度。

计费规则

支持按次、按量和混合计费。请求成功后按实际 Token 用量结算，失败请求不计费。

具体计费方式、套餐额度与余额可在用户面板查看。费用记录会显示到每次请求。

限速与并发

每个 API Key 都有独立的 RPM、TPM 和并发限制，当前数值可在用户面板查看。

当 RPM 或 TPM 受限时，响应会携带标准化的限速信息：

x-ratelimit-limit-requests: 60
x-ratelimit-remaining-requests: 42
x-ratelimit-reset-requests: 1784300000
retry-after: 12

常见错误码

{
  "error": {
    "type": "quota_exceeded",
    "code": "rpm_limit_exceeded",
    "message": "每分钟请求次数已达到上限",
    "reset_at": "2026-07-18T03:00:00.000Z"
  }
}

常见问题