返回首页

BuyApiKey 开发者文档

统一的大模型 API 网关,兼容 OpenAI 接口格式,一个 Key 调用 GPT / Claude / Gemini / Grok 全系模型

概述

BuyApiKey 提供统一的 AI 模型 API 接口,完全兼容 OpenAI API 格式。你只需要将基础地址替换为我们的地址,就可以无缝调用 OpenAI GPT、Anthropic Claude、Google Gemini、xAI Grok 等主流模型。

基础地址(Base URL):
https://buyapikey.com

常用接口端点:

价格说明:平台按人民币结算,充值与计费均以 ¥(元) 显示。各模型的具体单价见 模型广场

快速接入(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-你的密钥
安全提示:请勿在前端代码中直接暴露 API Key。建议通过后端服务器代理请求。

模型名称

直接使用模型名即可,无需任何厂商前缀。例如填写 gpt-5.4claude-opus-4-8gemini-3.6-flash,不要写成 openai/gpt-5.4 这种带斜杠的形式。

常用模型名称速查表

模型调用时填写的名称说明
GPT-5.6 Solgpt-5.6-solOpenAI 最新一代旗舰
GPT-5.6 Lunagpt-5.6-lunaOpenAI 最新一代
GPT-5.6 Terragpt-5.6-terraOpenAI 最新一代
GPT-5.5gpt-5.5OpenAI 旗舰
GPT-5.4gpt-5.4OpenAI 主力旗舰
GPT-5.4 Minigpt-5.4-miniOpenAI 高性价比
Codex 代码审查codex-auto-review代码审查专用
Claude Opus 5claude-opus-5Anthropic 最强旗舰
Claude Opus 4.8claude-opus-4-8Anthropic 旗舰
Claude Opus 4.7claude-opus-4-7Anthropic 旗舰
Claude Opus 4.6claude-opus-4-6Anthropic 旗舰
Claude Sonnet 5claude-sonnet-5新一代均衡旗舰
Claude Sonnet 4.6claude-sonnet-4-6均衡之选,编程强
Claude Haiku 4.5claude-haiku-4-5最快最省
Gemini 3.6 Flashgemini-3.6-flashGoogle 最新高速多模态
Gemini 3.5 Flashgemini-3.5-flashGoogle 高速多模态
DeepSeek V4 Prodeepseek-v4-proDeepSeek 旗舰
DeepSeek V4 Flashdeepseek-v4-flashDeepSeek 高性价比
GLM-5.2glm-5.2智谱旗舰,超低价
Grok 4.5grok-4.5xAI 旗舰
如何查看所有模型名称?
模型广场 页面点击任意模型,即可看到完整的模型名称,复制后直接用于 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

POST /v1/chat/completions

请求参数

参数类型必填说明
modelstring模型名称,如 gpt-5.4
messagesarray消息列表,包含 role 和 content
temperaturenumber温度系数 0-2,默认 1,越高越随机
max_tokensinteger最大输出 token 数
streamboolean是否流式输出,默认 false
top_pnumber核采样系数,默认 1
toolsarray函数调用/工具定义

消息格式

{
  "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
  }
}

获取模型列表

GET /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_urlhttps://api.openai.com/v1https://buyapikey.com/v1
api_key你的 OpenAI Key你的 BuyApiKey Key
支持的客户端和工具:ChatGPT Next Web、LobeChat、Cherry Studio、OpenCat、BotGem、Cursor、Continue、Cline、以及所有支持自定义 OpenAI API 地址的工具。

流式输出(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.4gemini-3.6-flashgemini-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.5claude-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.5xAI 风格,实时知识

错误处理

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.4claude-opus-4-8gemini-3.6-flashgrok-4.5

Q: 支持流式输出吗?

支持。在请求中设置 "stream": true 即可。

Q: 可以在哪些工具中使用?

所有支持自定义 OpenAI API 地址的工具都可以,包括 ChatGPT Next Web、LobeChat、Cherry Studio、Cursor、Continue、Cline、OpenCat 等。

Q: 如何查看使用量和余额?

登录控制台即可查看 Token 用量、余额(¥)和调用日志。

速率限制

默认速率限制取决于你的账户等级。如遇到 429 错误,请降低请求频率。建议:

还有其他问题?

返回首页 · 模型广场