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

请求参数

参数类型说明
modelstring模型 ID,见模型广场
messagesarray对话消息列表
streambool是否流式返回
max_tokensint最大输出 token 数
temperaturefloat采样温度 0-2
toolsarray工具调用定义

流式响应

设置 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上游异常自动重试中,通常几秒恢复