接入文档 — APIKey 中转站

快速开始

我们的接口与 OpenAI 官方接口完全兼容。你只需要两步：

获取 API Key：注册并登录控制台，在「API Keys」页面点击创建，复制以 sk- 开头的密钥。
替换 Base URL：把代码里的接口地址改成我们的地址，即可用同一个 Key 调用全部模型。

💡 注册即送体验额度，无需绑定支付方式即可开始测试。

Base URL

所有接口地址统一为：

https://api.example.com/v1

兼容的接口路径包括：

/v1/chat/completions — 对话补全（最常用）
/v1/completions — 文本补全
/v1/embeddings — 向量嵌入
/v1/models — 查询可用模型列表
/v1/audio/transcriptions — 语音转文字
/v1/images/generations — 图片生成

⚠️ 上线前请将 api.example.com 替换为你的真实域名。

curl 调用示例

基础对话

curl https://api.example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手。"},
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

模型切换

想换模型？只需要修改 model 字段，例如：

"model": "claude-3-7-sonnet"   # 切换 Claude
"model": "deepseek-chat"     # 切换 DeepSeek
"model": "gemini-2.0-pro"    # 切换 Gemini
"model": "glm-5.3-flash"     # 切换智谱最新 GLM

OpenAI SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://api.example.com/v1",   # 只需改这一行
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的APIKey",
  baseURL: "https://api.example.com/v1",   // 只需改这一行
});

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

流式输出（SSE）

与官方一致，设置 "stream": true 即可获得流式响应，适合接入聊天前端：

curl https://api.example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [{"role": "user", "content": "讲个笑话"}]
  }'

流式请求的计费与普通请求一致，按实际生成的 token 数计算，不会有额外费用。

接入自建本地模型

如果你（或你的朋友）部署了本地模型服务，只要它提供 OpenAI 兼容接口，即可接入本平台统一对外提供：

vLLM 部署的服务：原生兼容 OpenAI 接口，提供 Base URL 与 Key 即可。
Ollama：地址形如 http://192.168.x.x:11434/v1，兼容 OpenAI 格式。
LM Studio / llama.cpp server：同样提供 OpenAI 兼容端点。
其他中转站渠道：直接添加为上游渠道，自动纳入路由池。

👉 站长可在管理后台「渠道」中填写对方提供的 Base URL 与 Key，并给模型命名（如 local-llama3），用户即可直接调用。

客户端接入教程

我们的接口与 OpenAI 官方完全兼容，几乎所有 AI 工具都支持"自定义 OpenAI 兼容接口地址"。接入方法就一句话：把工具的接口地址换成 你的域名/v1，把 Key 换成你在本站创建的 API Key，其他什么都不用动。

聊天客户端（Cherry Studio / NextChat / LobeChat）

打开软件设置 → 找到「模型服务商 / 模型供应商」
选择（或添加）OpenAI 类型，或选择「自定义接口」
接口地址（Base URL）填：https://你的域名/v1
API Key 填：你在控制台创建的 sk-xxx
模型名填：控制台展示的模型名（如 gpt-4o、deepseek-chat）

OpenClaw（开源 Agent 框架）

在 OpenClaw 中自定义模型 Provider（Custom Provider）
Base URL 填：https://你的域名/v1
API Key 填：sk-xxx
选择 OpenAI 兼容协议，模型名填你的可用模型

Hermes Agent

通过环境变量指定 OpenAI 兼容端点：

OPENAI_BASE_URL=https://你的域名/v1
OPENAI_API_KEY=sk-你的APIKey
OPENAI_MODEL=gpt-4o

Dify / FastGPT / n8n 等平台

添加模型供应商时选择 OpenAI-API-Compatible（或 OpenAI 类型）
API Base URL 填：https://你的域名/v1
API Key 填：sk-xxx，选择模型后即可使用

自己写代码（任意语言）

只需把 SDK 的 base_url 指向我们：

from openai import OpenAI
client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://你的域名/v1",   # 唯一需要改的地方
)
resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

模型列表

查询当前可用模型：

curl https://api.example.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

常用模型速查：

模型名（model 字段）	说明
`gpt-4o`	OpenAI 旗舰多模态模型
`gpt-4o-mini`	轻量高性价比
`claude-3-7-sonnet`	Anthropic 旗舰，擅长编码与长文本
`claude-3-5-haiku`	Anthropic 轻量模型
`gemini-2.0-pro`	Google 旗舰，百万上下文
`deepseek-chat`	DeepSeek V3，性价比极高
`deepseek-reasoner`	DeepSeek R1 推理模型
`qwen-max` / `glm-4-plus` / `doubao-pro-32k`	国产模型
`glm-5.3-flash`	智谱最新开源多模态模型（1M 上下文，支持图片输入）
`local-*`	自建/第三方本地模型（按渠道命名）

错误码说明

HTTP 状态码	说明	处理建议
`401`	API Key 无效或未提供	检查请求头 Authorization 是否正确
`402`	余额不足	前往控制台充值
`404`	模型不存在	确认模型名拼写，或查看模型列表
`429`	请求过于频繁，触发限流	降低并发，稍后重试
`500`	上游服务异常	稍后重试；系统会自动切换备用渠道
`503`	服务维护中	关注状态页公告

速率限制

为防止滥用，不同套餐有对应的速率限制（演示数据，可配置）：

套餐	请求频率	并发上限
按量付费	60 次 / 分钟	10
标准套餐	300 次 / 分钟	50
专业套餐	1000 次 / 分钟	200

返回 429 时，响应头中的 Retry-After 会告知需要等待的秒数。

计费说明

每次调用按「输入 tokens × 输入单价 + 输出 tokens × 输出单价」实时结算。
请求以 stream 方式输出时，按实际生成的 tokens 计费。
余额为 0 或不足时，请求将返回 402，不会产生欠费。
套餐折扣在结算时自动应用，可在控制台查看每笔调用的明细费用。

如需更详细的 API 说明或有其他问题，请在控制台提交工单，我们 24 小时在线。