API 文档
完全兼容 OpenAI 协议,把 base_url 换成我们的地址即可。
快速开始
三步接入:
- 登录控制台,创建 API 密钥
- 把
base_url设为https://hub.gpt700.com/v1 - 用密钥替换原来的 OpenAI API Key
Python
from openai import OpenAI client = OpenAI( api_key="sk-你的密钥", base_url="https://hub.gpt700.com/v1" ) resp = client.chat.completions.create( model="deepseek-v4.1-flash", messages=[{"role": "user", "content": "你好"}] ) print(resp.choices[0].message.content)
cURL
curl https://hub.gpt700.com/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的密钥" \ -d '{ "model": "deepseek-v4.1-flash", "messages": [{"role": "user", "content": "你好"}] }'
Node.js
import OpenAI from 'openai'; const client = new OpenAI({ apiKey: 'sk-你的密钥', baseURL: 'https://hub.gpt700.com/v1' });
认证方式
所有请求都通过 HTTP Header 传递密钥:
Authorization: Bearer sk-xxxxxxxxxxxxxxxx
密钥在控制台「API 密钥」页面创建,可设置额度上限与 IP 白名单。泄漏后请立即删除重建。
对话接口
POST /v1/chat/completions
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 模型 ID,见模型广场 |
messages | array | 对话消息列表 |
stream | bool | 是否流式返回 |
max_tokens | int | 最大输出 token 数 |
temperature | float | 采样温度 0-2 |
tools | array | 工具调用定义 |
流式响应
设置 stream: true 后返回 SSE 数据流:
data: {"choices":[{"delta":{"content":"你"}}]}
data: {"choices":[{"delta":{"content":"好"}}]}
data: [DONE]
建议客户端超时设置为 300 秒以上。长输出现象(如代码生成)可能持续 2-3 分钟,超时过短会在中途断开。
模型列表
GET /v1/models — 返回当前密钥可用的模型
curl https://hub.gpt700.com/v1/models \
-H "Authorization: Bearer sk-你的密钥"
返回格式兼容 OpenAI:
{"data":[{"id":"deepseek-v4.1-flash","object":"model"}]}
计费说明
按 token 用量计费,标准价如下(单位:元 / 百万 tokens):
| 类型 | 标准价 | 说明 |
|---|---|---|
| 输入 | 2.00 | 普通输入 token |
| 输出 | 8.00 | 模型生成的 token |
| 缓存读取 | 0.80 | 命中上下缓存的输入,便宜 60% |
最终扣费 = 标准价 × 通道倍率。各通道倍率见通道介绍。
失败请求(上游报错、超时、断流)不计费。余额不足时接口返回 402。
错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
401 | 密钥无效 | 检查 Authorization Header |
402 | 余额不足 | 充值后重试 |
403 | 模型不在该通道 | 换通道或换模型 |
404 | 模型不存在 | 查模型广场确认 ID |
429 | 请求频率超限 | 降低并发或稍后重试 |
500 | 服务内部错误 | 重试,持续报错联系客服 |
502 | 上游异常 | 自动重试中,通常几秒恢复 |