BingoAPI API 参考

BingoAPI 提供与 OpenAI 完全兼容的接口。接入只需三步：创建 API Key、配置 base_url、发起请求。所有接口均支持 HTTPS 与 HTTP。

Base URL：http://119.28.45.212:3000/v1　（域名上线后将自动迁移，SDK 配置无需改动）

快速开始

登录控制台，进入「API 密钥」创建密钥（新用户注册即赠 $0.15 体验金）；
在 SDK 或请求中配置 base_url = http://119.28.45.212:3000/v1；
选择模型名（如 deepseek-flash）发起请求。

curl 示例：

# 1) 将 sk-your-key 替换为你的密钥
curl http://119.28.45.212:3000/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "user", "content": "你好，用一句话介绍你自己"}
    ]
  }'

身份认证

BingoAPI 使用 API Key 进行身份认证。请求时在请求头携带：

Authorization: Bearer sk-your-api-key

密钥在控制台「API 密钥」页面创建，创建后仅显示一次，请妥善保存；
支持创建无限配额 / 永不过期密钥，适合生产环境；
如密钥泄露，请在控制台删除并新建，旧密钥立即失效。

Python（OpenAI SDK）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="http://119.28.45.212:3000/v1",
)

resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

模型列表

模型 ID	定位	适用场景
deepseek-flash	轻量高速	日常对话、内容生成、批量任务
deepseek-v4-pro	旗舰推理	复杂推理、高要求业务场景

更多模型持续接入中。请求时在 model 字段传入模型 ID 即可，未来新增模型无需改动代码。

对话补全

POST/v1/chat/completions

创建一次对话补全请求，与 OpenAI Chat Completions 接口一致。

请求参数（部分）

参数	类型	必填	说明
model	string	是	模型 ID，见「模型列表」
messages	array	是	对话消息数组，role 取值 system / user / assistant
temperature	number	否	采样温度 0-2，默认 1
max_tokens	integer	否	生成的最大 token 数
stream	boolean	否	是否流式返回，默认 false

流式（SSE）示例：

curl http://119.28.45.212:3000/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "stream": true,
    "messages": [{"role": "user", "content": "你好"}]
  }'

响应格式

非流式响应与 OpenAI 格式一致，关键字段：

字段	说明
id	本次请求 ID
model	实际使用的模型
choices[0].message.content	模型生成的文本内容
usage.prompt_tokens	输入 token 数（计入输入单价）
usage.completion_tokens	输出 token 数（计入输出单价）
usage.prompt_cache_hit_tokens	缓存命中 token 数（计入缓存单价）

错误码

出错时返回 HTTP 状态码与 {error: {...}} 结构体，与 OpenAI 兼容：

HTTP	类型	含义
401	authentication_error	API Key 无效或已失效
403	permission_error	密钥无权访问该模型
429	insufficient_quota	余额或配额不足，请充值后重试
429	rate_limit_error	请求过于频繁
400	invalid_request_error	请求参数错误（如 model 不存在）
5xx	api_error	服务端异常，稍后重试

定价

统一加价 40%，无隐藏费用。美元计价，人民币按 USD/CNY 6.6558 折算参考，实际扣费以面板账单为准。

DeepSeek Flash

deepseek-flash

输入 / 1M token$0.4207 ≈ ¥2.80

缓存命中 / 1M token$0.0084 ≈ ¥0.06

输出 / 1M token$1.6827 ≈ ¥11.20

DeepSeek Pro

deepseek-v4-pro

输入 / 1M token$1.8931 ≈ ¥12.60

缓存命中 / 1M token$0.0631 ≈ ¥0.42

输出 / 1M token$5.6793 ≈ ¥37.80

余额消耗示例：使用 deepseek-flash 产生 1,000 输入 + 2,000 输出的请求，费用为 $0.4207 × 0.001 + $1.6827 × 0.002 ≈ $0.0038。

充值

兑换码充值：在控制台「充值」页面输入兑换码，到账后余额立即可用；
人工充值：联系管理员转账后，后台直接为账户加款；
自助支付：支付网关接入中，上线后支持在线付款。

余额为账户级共享，同一账户下所有密钥共用。实时余额可在控制台首页查看。

常见问题

一个 Key 可以用所有模型吗？

可以。同一密钥可调用已上线的全部模型，无需为模型分别创建密钥。

如何保证调用稳定？

中转层具备渠道级连接管理与失败重试，调用日志全程可追溯。如遇瞬时错误（5xx），建议指数退避重试。

新用户体验金如何使用？

注册即赠 $0.15 体验金，可在控制台游乐场直接试跑，也可用于 API 调用，先用后充。

余额可以退回吗？

兑换码充值与人工充值的余额为预付款项，建议按需充值。如账户闲置，可联系管理员协商处理。