返回文档首页

API 文档

OpenAI 兼容接口文档。任何支持 OpenAI SDK 的工具填入 Base URL 和密钥即可直接使用。

基本信息

项目值
Base URLhttps://103.236.87.35/v1
认证方式请求头 Authorization: Bearer <你的密钥>
数据格式JSON (UTF-8)
计费单位元 / 百万 Token

快速开始

curl https://103.236.87.35/v1/chat/completions \
  -H "Authorization: Bearer <你的密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python SDK

from openai import OpenAI
client = OpenAI(api_key="<你的密钥>", base_url="https://103.236.87.35/v1")
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

接口列表

点击任意接口卡片查看完整文档（请求方法 / 请求示例 / 参数 / 返回示例）。

POST按 Token 计费
/v1/chat/completions
Chat 对话：与 AI 模型多轮对话，支持流式输出。最常用的接口。
参数：model · messages · temperature · max_tokens · stream
 POST按 Token 计费
/v1/completions
文本补全：给一段文本开头，让模型续写后续内容。
参数：model · prompt · max_tokens · temperature
 POST按 Token 计费
/v1/embeddings
Embeddings 向量：把文本转换成数值向量，用于语义搜索、相似度计算。
参数：model · input · encoding_format
 POST按 Token 计费
/v1/responses
Responses API：OpenAI 新一代对话接口，支持工具调用与结构化输出。
参数：model · input · instructions · max_output_tokens
 GET不计费
/v1/models
模型列表：查询当前平台可用的所有模型。
参数：无需参数
 GET不计费
/v1/me
账号余额查询：用 sk- 密钥查询所属账号的余额、套餐与账号信息。
参数：无需参数（别名 /v1/balance）
 GET/POST不计费
/v1/notifications
平台通知：拉取平台推送的公告、余额告警等消息，并标记已读。
参数：GET 拉取 / POST 传 ids 标记已读
 GET不计费
/v1/_install_check
安装自检：验证站点伪静态配置是否正确的探针接口。
参数：无需参数

错误格式

所有错误统一返回 OpenAI 风格 JSON：

{
  "error": {
    "message": "错误描述",
    "type": "new_api_error",
    "param": "",
    "code": "invalid_api_key"
  }
}
状态码含义
200成功（流式为 text/event-stream）
400请求体格式错误（透传上游）
401未提供 Token / 密钥无效
402余额不足 / 密钥额度用尽
403密钥封禁 / 停用 / 用户禁用 / IP 受限 / 模型无权
404路径不存在 / 模型未配置
405方法不允许
429模型限速（RPM）/ 上游限速
502上游请求失败

鉴权与权限

除 _install_check、models（模型列表）外，所有接口都需要 Authorization: Bearer <密钥>，网关按顺序校验：

  1. 密钥存在性 — 无效返回 401 invalid_api_key
  2. 密钥状态 — 封禁 403 key_banned / 停用 403 key_disabled（封禁到期自动解封）
  3. 账号状态 — 用户禁用 403 user_disabled
  4. 套餐过期 — 自动收回赠送额度
  5. IP 黑白名单 — 黑名单 403 ip_blacklisted / 白名单外 403 ip_not_allowed
  6. 模型权限 — 密钥白名单外 403 model_not_allowed
  7. 模型限速 — 60 秒内超 RPM 429 rate_limit_exceeded
  8. 密钥额度 — 用尽 402 quota_exceeded
  9. 账号余额 — 余额 ≤ 0 402 insufficient_balance

计费说明

自动故障转移

模型绑定平台的多密钥池管理，对调用方完全透明：

  1. 平台下所有启用密钥组成密钥池
  2. 按「累计调用次数少的优先 + 组内随机」负载均衡
  3. 逐个检查密钥余额（60 秒缓存）：不足自动跳过
  4. 请求失败 / 限速 / 上游 5xx 自动换下一个密钥重试
  5. 平台池全挂 → 跨平台备用 → 全局上游兜底
  6. 切换失败或上游错误时自动通知管理员

其他接口

接口说明
POST /v1/chat/completionsChat 对话（流式 SSE）查看 →
POST /v1/completions文本补全查看 →
POST /v1/embeddings向量嵌入查看 →
POST /v1/responsesResponses API查看 →
GET /v1/models模型列表查看 →
GET /v1/me账号余额查询查看 →
GET/POST /v1/notifications平台通知查看 →
GET /v1/_install_check安装自检查看 →