BuyApiKey 开发者文档
统一的大模型 API 网关,兼容 OpenAI 接口格式,一个 Key 调用 GPT / Claude / Gemini / Grok 全系模型
概述
BuyApiKey 提供统一的 AI 模型 API 接口,完全兼容 OpenAI API 格式。你只需要将基础地址替换为我们的地址,就可以无缝调用 OpenAI GPT、Anthropic Claude、Google Gemini、xAI Grok 等主流模型。
https://buyapikey.com
常用接口端点:
/v1/chat/completions— 对话补全(最常用)/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": "gpt-5.4",
"messages": [{"role": "user", "content": "你好"}]
}'
认证方式
所有 API 请求需要在 Header 中携带 API Key:
Authorization: Bearer sk-你的密钥
模型名称
gpt-5.4、claude-opus-4-8、gemini-3.6-flash,不要写成 openai/gpt-5.4 这种带斜杠的形式。
常用模型名称速查表
| 模型 | 调用时填写的名称 | 说明 |
|---|---|---|
| GPT-5.6 Sol | gpt-5.6-sol | OpenAI 最新一代旗舰 |
| GPT-5.6 Luna | gpt-5.6-luna | OpenAI 最新一代 |
| GPT-5.6 Terra | gpt-5.6-terra | OpenAI 最新一代 |
| GPT-5.5 | gpt-5.5 | OpenAI 旗舰 |
| GPT-5.4 | gpt-5.4 | OpenAI 主力旗舰 |
| GPT-5.4 Mini | gpt-5.4-mini | OpenAI 高性价比 |
| Codex 代码审查 | codex-auto-review | 代码审查专用 |
| Claude Opus 5 | claude-opus-5 | Anthropic 最强旗舰 |
| Claude Opus 4.8 | claude-opus-4-8 | Anthropic 旗舰 |
| Claude Opus 4.7 | claude-opus-4-7 | Anthropic 旗舰 |
| Claude Opus 4.6 | claude-opus-4-6 | Anthropic 旗舰 |
| Claude Sonnet 5 | claude-sonnet-5 | 新一代均衡旗舰 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | 均衡之选,编程强 |
| Claude Haiku 4.5 | claude-haiku-4-5 | 最快最省 |
| 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 旗舰 |
在 模型广场 页面点击任意模型,即可看到完整的模型名称,复制后直接用于 API 调用。
调用示例
# 调用 GPT-5.4
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "你好"}]
}'
# 调用 Claude Opus 4.8
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": "你好"}]
}'
# 调用 Gemini 3.1 Pro
curl https://buyapikey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.6-flash",
"messages": [{"role": "user", "content": "证明勾股定理"}]
}'
对话补全 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-你的密钥"
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.4-mini',
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 |
流式输出(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
)
# 模型会展示完整的思考过程
热门模型推荐
| 使用场景 | 推荐模型 | 特点 |
|---|---|---|
| 日常对话 | gpt-5.4-mini | 便宜快速,能力均衡 |
| 编程开发 | claude-opus-5 | 代码质量高,理解力强 |
| 均衡编程 | claude-sonnet-5 | 速度与质量兼顾 |
| 深度推理 | gpt-5.5 | 深度思考,逻辑严谨 |
| 高性价比 | glm-5.2 | 超低价,能力扎实 |
| 识图 / 多模态 | gemini-3.6-flash | 高速多模态 |
| 中文 / 长文 | deepseek-v4-pro | 中文理解强 |
| 通用对话 | grok-4.5 | xAI 风格,实时知识 |
错误处理
| HTTP 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求参数错误 | 检查 JSON 格式和必填参数 |
| 401 | 认证失败 | 检查 API Key 是否正确 |
| 402 | 余额不足 | 充值后重试 |
| 429 | 请求频率过高 | 降低请求频率或稍后重试 |
| 500 | 服务器内部错误 | 稍后重试,如持续请联系客服 |
| 503 | 上游模型暂不可用 | 尝试其他模型或稍后重试 |
错误响应格式
{
"error": {
"message": "错误描述信息",
"type": "error_type",
"code": "error_code"
}
}
常见问题
Q: 支持哪些模型?
覆盖六大厂商的主流模型:OpenAI(GPT-5.6 系列 / GPT-5.5 / GPT-5.4 / Codex)、Anthropic(Claude Opus 4.6~5、Sonnet 4.6/5、Haiku 4.5)、Google(Gemini 3.5/3.6 Flash)、DeepSeek(V4 Pro / Flash)、智谱(GLM-5.2)、xAI(Grok 4.5)。完整列表见 模型广场。
Q: 和 OpenAI 官方 API 有什么区别?
接口格式完全一致,但优势是:一个 Key 即可使用多家厂商的模型,无需分别注册和充值,且按人民币结算。
Q: 模型名称怎么填?
直接填模型名,不需要厂商前缀。例如 gpt-5.4、claude-opus-4-8、gemini-3.6-flash、grok-4.5。
Q: 支持流式输出吗?
支持。在请求中设置 "stream": true 即可。
Q: 可以在哪些工具中使用?
所有支持自定义 OpenAI API 地址的工具都可以,包括 ChatGPT Next Web、LobeChat、Cherry Studio、Cursor、Continue、Cline、OpenCat 等。
Q: 如何查看使用量和余额?
登录控制台即可查看 Token 用量、余额(¥)和调用日志。
速率限制
默认速率限制取决于你的账户等级。如遇到 429 错误,请降低请求频率。建议:
- 添加重试逻辑,遇到 429 时指数退避重试
- 使用流式输出减少并发连接时间
- 对非实时任务使用队列控制并发