BuyApiKey 开发者文档 · API中转接入
国内 API 中转站。兼容 OpenAI 接口格式,一个 Key 调用 Claude / GPT / Gemini。Claude API 中转,国内直连。
概述
BuyApiKey 提供统一的 AI 模型 API 接口,完全兼容 OpenAI API 格式。你只需要将基础地址替换为我们的地址,就可以无缝调用 OpenAI GPT、Anthropic Claude、Google Gemini、xAI Grok 等主流模型。
OpenAI SDK 和大多数工具填
https://buyapikey.com/v1;少数会自己在后面拼 /v1 的工具(例如 Claude Code),填 https://buyapikey.com。
支持的接口:
/v1/chat/completions— 对话补全,OpenAI 格式(最常用)/v1/responses— OpenAI Responses 格式/v1/messages— Claude 原生格式(Claude Code、Anthropic SDK)/v1beta/models/{模型}:generateContent— Gemini 原生格式(Google GenAI SDK)/v1/images/generations、/v1/images/edits— 图片生成 / 改图/v1/models— 获取可用模型列表
快速接入(3 分钟上手)
第 1 步:获取 API Key
登录 buyapikey.com,在控制台创建令牌(Token),获得格式为 sk-xxx 的 API Key。
第 2 步:替换 Base URL
将你代码中的 OpenAI 基础地址替换为:
# 原来
https://api.openai.com
# 改为
https://buyapikey.com
第 3 步:调用 API
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"messages": [{"role": "user", "content": "你好"}]
}'
认证方式
所有 API 请求需要在 Header 中携带 API Key:
Authorization: Bearer sk-你的密钥
模型名称
claude-opus-5、gpt-5.5、gemini-3.6-flash,不要写成 openai/gpt-5.5 这种带斜杠的形式。唯一例外是 Cursor:Cursor 自带了同名模型,要在名字前加
byk-,见 在 Cursor 中使用。
常用模型名称速查表
| 模型 | 调用时填写的名称 | 说明 |
|---|---|---|
| Claude Opus 5.5 | claude-opus-5-5 | Anthropic 最新旗舰 |
| Claude Opus 5 | claude-opus-5 | Anthropic 旗舰,本站调用量第一 |
| Claude Fable 5.1 | claude-fable-5-1 | 创作与复杂推理 |
| Claude Opus 4.8 | claude-opus-4-8 | Anthropic 旗舰 |
| Claude Sonnet 5 | claude-sonnet-5 | 新一代均衡旗舰 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | 均衡之选,编程强 |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 | 最快最省 |
| GPT-5.6 Sol | gpt-5.6-sol | OpenAI 最新一代旗舰 |
| GPT-5.6 Terra | gpt-5.6-terra | OpenAI 最新一代 |
| GPT-5.6 Luna | gpt-5.6-luna | OpenAI 最新一代,轻量快速 |
| GPT-5.5 | gpt-5.5 | OpenAI 旗舰,深度推理 |
| GPT-5.4 | gpt-5.4 | OpenAI 主力 |
| Gemini 3.1 Pro | gemini-3.1-pro-preview | Google 旗舰推理 |
| Gemini 3.8 Flash | gemini-3.8-flash | Google 最新高速多模态 |
| Gemini 3.6 Flash | gemini-3.6-flash | Google 高速多模态 |
| Gemini 3.5 Flash | gemini-3.5-flash | Google 高速多模态 |
| DeepSeek V4 Pro | deepseek-v4-pro | DeepSeek 旗舰 |
| DeepSeek V4 Flash | deepseek-v4-flash | DeepSeek 高性价比 |
| GLM-5.2 | glm-5.2 | 智谱旗舰 |
| Grok 4.5 | grok-4.5 | xAI 旗舰 |
| GPT Image 2.5 | gpt-image-2.5 | 图片生成 / 改图,见 图片生成 |
在 模型广场 页面点击任意模型,即可看到完整的模型名称,复制后直接用于 API 调用。
调用示例
# 调用 GPT-5.5
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "你好"}]
}'
# 调用 Claude Opus 5
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"messages": [{"role": "user", "content": "你好"}]
}'
# 调用 Gemini 3.1 Pro
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro-preview",
"messages": [{"role": "user", "content": "证明勾股定理"}]
}'
在 Cursor 中使用
Cursor 自己内置了 claude-opus-5、gpt-5.5 等同名模型。在自定义接口里填原名,Cursor 会提示"already available"并拦住。所以在 Cursor 里,模型名前面加 byk-。它和原名是同一个模型、同一个价格。
设置步骤
- 打开 Cursor 设置 → Models。
- 在 OpenAI API Key 里填你的 BuyApiKey 令牌(
sk-xxx)。 - 打开 Override OpenAI Base URL,填
https://buyapikey.com/v1。 - 点 Add model,填下表里的名字(例如
byk-claude-opus-5),打开开关后就能在对话框里选用。
| 想用的模型 | 在 Cursor 里填 |
|---|---|
| Claude Opus 5.5 | byk-claude-opus-5-5 |
| Claude Opus 5 | byk-claude-opus-5 |
| Claude Sonnet 5 | byk-claude-sonnet-5 |
| Claude Opus 4.8 | byk-claude-opus-4-8 |
| Claude Fable 5.1 | byk-claude-fable-5-1(旧名 fable-5-1 也能用) |
| GPT-5.6 Sol | byk-gpt-5.6-sol |
| GPT-5.5 | byk-gpt-5.5 |
| Gemini 3.1 Pro | byk-gemini-3.1-pro-preview |
| Gemini 3.8 Flash | byk-gemini-3.8-flash |
| 其他模型 | 模型广场里带 Cursor 标签的都能用,名字就是原名前加 byk- |
byk- 名字也一样能通。
在 Claude Code 中使用
Claude Code 走 Claude 原生接口,用环境变量设置。必填的只有地址和密钥两个,模型名可选。注意 Base URL 不要带 /v1:
# macOS / Linux
export ANTHROPIC_BASE_URL="https://buyapikey.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="claude-opus-5" # 主模型
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001" # 后台小任务用(旧版变量名)
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001" # 后台小任务用(新版变量名)
claude
# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://buyapikey.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
$env:ANTHROPIC_MODEL="claude-opus-5"
claude
可用的 Claude 模型:claude-opus-5-5、claude-opus-5、claude-opus-4-8、claude-fable-5-1、claude-sonnet-5、claude-sonnet-4-6、claude-haiku-4-5-20251001。
MT5 / 交易 EA 接入建议
交易机器人大多是"不流式、一次等整段回答"。回答越长等得越久,客户端超时设短了,就会表现为"连不上"。按下面设置基本不会再遇到:
- 超时设 120 秒以上。30 秒的超时对 Claude / GPT 这类大模型太短,长回答必然超时。
- 控制回答长度。信号类请求把
max_tokens设到够用即可(例如 500–1500),要求模型"只输出 JSON / 只输出结论",速度会快很多。 - 按时效选模型。要秒级出信号用 Gemini Flash;要深度分析用 Claude Opus 5。
- 失败后等几秒再重试。不要超时后立刻连发,服务端已经会自动换线路重试。
各模型整段回答的典型耗时(非流式,近 24 小时实测平均)
| 模型 | 平均耗时 | 适合 |
|---|---|---|
gemini-3.6-flash / gemini-3.8-flash | 约 15–20 秒 | 实时信号、快速判断、识图 |
gpt-5.6-luna | 约 25 秒 | 轻量分析 |
claude-opus-5 | 约 25 秒 | 深度分析,综合最好 |
gemini-3.1-pro-preview | 约 30 秒 | 推理 |
claude-sonnet-5 / gpt-5.6-sol | 约 40–45 秒 | 均衡 |
gpt-5.5 | 约 60 秒 | 深度推理,不适合实时 |
耗时随回答长度和时段变化,以上为 2026 年 10 月 1 日统计。
对话补全 API
/v1/chat/completions
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称,如 gpt-5.4 |
messages | array | 是 | 消息列表,包含 role 和 content |
temperature | number | 否 | 温度系数 0-2,默认 1,越高越随机 |
max_tokens | integer | 否 | 最大输出 token 数 |
stream | boolean | 否 | 是否流式输出,默认 false |
top_p | number | 否 | 核采样系数,默认 1 |
tools | array | 否 | 函数调用/工具定义 |
消息格式
{
"messages": [
{"role": "system", "content": "你是一个有帮助的助手"},
{"role": "user", "content": "介绍一下人工智能"},
{"role": "assistant", "content": "人工智能是..."},
{"role": "user", "content": "继续深入讲讲"}
]
}
响应示例
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-5.4",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "人工智能(AI)是计算机科学的一个分支..."
},
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 150,
"total_tokens": 170
}
}
获取模型列表
/v1/models
返回当前可用的所有模型列表。
curl https://buyapikey.com/v1/models \
-H "Authorization: Bearer sk-你的密钥"
Claude 原生接口
/v1/messages
与 Anthropic 官方格式一致,认证用 x-api-key 或 Authorization: Bearer 都可以。
curl https://buyapikey.com/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'
Anthropic Python SDK:
import anthropic
client = anthropic.Anthropic(api_key="sk-你的密钥", base_url="https://buyapikey.com")
msg = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
Gemini 原生接口
/v1beta/models/{模型}:generateContent
与 Google Gemini 官方格式一致。密钥放在 x-goog-api-key 请求头里,或者放在网址参数 ?key= 里。
curl "https://buyapikey.com/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "你好"}]}]
}'
Google GenAI Python SDK:
from google import genai
client = genai.Client(api_key="sk-你的密钥", http_options={"base_url": "https://buyapikey.com"})
resp = client.models.generate_content(model="gemini-3.8-flash", contents="你好")
print(resp.text)
可用的 Gemini 模型:gemini-3.8-flash、gemini-3.6-flash、gemini-3.5-flash、gemini-3.1-pro-preview。
图片生成
/v1/images/generations(文字生成图片)
/v1/images/edits(上传图片 + 文字改图)
按张计费,单价见 模型广场。一张图通常 20–60 秒,客户端超时请设 180 秒以上。返回 b64_json(图片的 Base64 编码)。
from openai import OpenAI
import base64
client = OpenAI(api_key="sk-你的密钥", base_url="https://buyapikey.com/v1")
# 文字生成图片
img = client.images.generate(model="gpt-image-2.5", prompt="白色桌面上的一个红苹果,产品摄影", size="1024x1024")
open("apple.png", "wb").write(base64.b64decode(img.data[0].b64_json))
# 上传图片改图
img = client.images.edit(model="gpt-image-2.5", image=open("product.png", "rb"), prompt="换成纯白背景的电商主图")
open("product_white.png", "wb").write(base64.b64decode(img.data[0].b64_json))
Python 示例
使用 OpenAI SDK(推荐)
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://buyapikey.com/v1"
)
# 普通对话
response = client.chat.completions.create(
model="gpt-5.4",
messages=[
{"role": "system", "content": "你是一个有帮助的助手"},
{"role": "user", "content": "用Python写一个快速排序"}
],
temperature=0.7,
max_tokens=2000
)
print(response.choices[0].message.content)
流式输出
stream = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "写一首关于春天的诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
使用 requests 库
import requests
response = requests.post(
"https://buyapikey.com/v1/chat/completions",
headers={
"Authorization": "Bearer sk-你的密钥",
"Content-Type": "application/json"
},
json={
"model": "gemini-3.6-flash",
"messages": [{"role": "user", "content": "证明勾股定理"}],
"max_tokens": 4000
}
)
print(response.json()["choices"][0]["message"]["content"])
Node.js 示例
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-你的密钥',
baseURL: 'https://buyapikey.com/v1'
});
async function main() {
const response = await client.chat.completions.create({
model: 'gpt-5.6-luna',
messages: [{ role: 'user', content: '你好,请介绍一下自己' }],
});
console.log(response.choices[0].message.content);
}
main();
流式输出
const stream = await client.chat.completions.create({
model: 'gemini-3.6-flash',
messages: [{ role: 'user', content: '写一个Node.js HTTP服务器' }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content || '');
}
cURL 示例
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"messages": [
{"role": "user", "content": "解释量子计算的基本原理"}
],
"temperature": 0.7,
"max_tokens": 2000
}'
兼容 OpenAI SDK
BuyApiKey 完全兼容 OpenAI SDK,你只需要修改两个参数即可:
| 参数 | 原 OpenAI | 改为 BuyApiKey |
|---|---|---|
| base_url | https://api.openai.com/v1 | https://buyapikey.com/v1 |
| api_key | 你的 OpenAI Key | 你的 BuyApiKey Key |
byk- 模型名,见 在 Cursor 中使用;Claude Code 见 在 Claude Code 中使用。
流式输出(SSE)
设置 stream: true 启用流式输出,服务器会以 Server-Sent Events (SSE) 格式逐 token 返回结果,显著提升用户体验。
// 请求中添加
{
"stream": true
}
// 响应格式(每行一个 chunk)
data: {"choices":[{"delta":{"content":"你"},"index":0}]}
data: {"choices":[{"delta":{"content":"好"},"index":0}]}
data: {"choices":[{"delta":{"content":"!"},"index":0}]}
data: [DONE]
函数调用 / 工具使用
{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "北京今天天气怎么样?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "获取指定城市的天气信息",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "城市名称"}
},
"required": ["city"]
}
}
}]
}
图像理解(视觉)
支持识图的模型(如 gpt-5.4、gemini-3.6-flash、gemini-3.5-flash)可以理解图片内容:
{
"model": "gemini-3.6-flash",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "描述这张图片"},
{"type": "image_url", "image_url": {
"url": "https://example.com/photo.jpg"
}}
]
}]
}
思维链推理
带"思考"能力的模型(如 gpt-5.5、claude-opus-5)支持深度推理:
# 使用 GPT-5.5 进行深度推理
response = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "证明:对于所有正整数n,1+2+...+n = n(n+1)/2"}],
max_tokens=8000
)
# 模型会展示完整的思考过程
热门模型推荐
| 使用场景 | 推荐模型 | 特点 |
|---|---|---|
| 交易信号 / 要快 | gemini-3.8-flash、gemini-3.6-flash | 整段回答约 15–20 秒 |
| 深度分析 / 编程 | claude-opus-5 | 质量最好,本站调用量第一 |
| 均衡编程 | claude-sonnet-5 | 速度与质量兼顾 |
| 日常对话 / 轻量 | gpt-5.6-luna | 便宜快速 |
| 深度推理 | gpt-5.5、gemini-3.1-pro-preview | 思考更深,耗时更长 |
| 识图 / 多模态 | gemini-3.8-flash | 高速多模态 |
| 中文 / 长文 | deepseek-v4-pro | 中文理解强 |
| 生图 / 改图 | gpt-image-2.5 | 电商主图、产品图 |
错误处理
| HTTP 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求参数错误 | 检查 JSON 格式和必填参数 |
| 401 | 认证失败 | 检查 API Key 是否正确 |
| 402 / 403 | 余额不足,或令牌额度用完 | 充值,或在控制台调高令牌额度 |
| 429 | 请求频率过高 | 降低请求频率或稍后重试 |
| 500 | 服务器内部错误 | 稍后重试,如持续请联系客服 |
| 503 | 上游模型暂不可用 | 尝试其他模型或稍后重试 |
| 客户端超时 / 连接被断开 | 回答还没生成完,客户端先放弃了 | 把超时调到 120 秒以上,或换更快的模型,见 EA 接入建议 |
错误响应格式
{
"error": {
"message": "错误描述信息",
"type": "error_type",
"code": "error_code"
}
}
常见问题
Q: 支持哪些模型?
覆盖主流厂商:OpenAI(GPT-5.6 Sol / Terra / Luna、GPT-5.5、GPT-5.4)、Anthropic(Claude Opus 5.5 / 5 / 4.8、Fable 5.1、Sonnet 5 / 4.6、Haiku 4.5)、Google(Gemini 3.1 Pro、3.8 / 3.6 / 3.5 Flash)、DeepSeek(V4 Pro / Flash)、智谱(GLM)、xAI(Grok),以及 gpt-image-2.5 生图。完整列表和实时价格见 模型广场。
Q: 和 OpenAI 官方 API 有什么区别?
接口格式完全一致,但优势是:一个 Key 即可使用多家厂商的模型,无需分别注册和充值,且按人民币结算。
Q: 模型名称怎么填?
直接填模型名,不需要厂商前缀。例如 claude-opus-5、gpt-5.5、gemini-3.6-flash。在 Cursor 里要在前面加 byk-,例如 byk-claude-opus-5。
Q: 支持流式输出吗?
支持。在请求中设置 "stream": true 即可。
Q: 可以在哪些工具中使用?
所有支持自定义 OpenAI API 地址的工具都可以,包括 ChatGPT Next Web、LobeChat、Cherry Studio、Continue、Cline、OpenCat 等。Cursor 见 这里,Claude Code 见 这里,Google / Anthropic 官方 SDK 也可以直接用。
Q: 请求很慢,或者经常超时 / 连不上?
多数是客户端超时设得太短:大模型写一段长回答要几十秒。把超时调到 120 秒以上、限制回答长度,或换 Gemini Flash 这类快的模型。详见 MT5 / 交易 EA 接入建议。
Q: 如何查看使用量和余额?
登录控制台即可查看 Token 用量、余额(¥)和调用日志。
速率限制
默认速率限制取决于你的账户等级。如遇到 429 错误,请降低请求频率。建议:
- 添加重试逻辑,遇到 429 时指数退避重试
- 使用流式输出减少并发连接时间
- 对非实时任务使用队列控制并发