几步接入 BG API。

01 · 创建密钥和配置额度

注册登录后，在控制台创建 API 密钥。请管理员配置模型并添加测试额度。

02 · 发送文字请求

Base URL：https://www.bgapi.net/v1。请使用上面显示的本站域名。

curl https://www.bgapi.net/v1/chat/completions \
  -H "Authorization: Bearer 你的BG密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"管理员配置的模型ID","messages":[{"role":"user","content":"你好"}],"max_tokens":512,"stream":false}'

Windows PowerShell 建议使用 curl.exe，并将 JSON 保存到文件后用 --data-binary @request.json 发送。

03 · 查询可用模型

GET /v1/models
Authorization: Bearer 你的BG密钥

计费说明

按上游返回的 prompt_tokens、completion_tokens 和平台销售价格结算。已配置缓存价时，将 prompt_tokens 中的 cached_tokens 分出并按缓存价计算；未配置缓存价却返回缓存用量时进入人工核账。缓存创建及长上下文阶梯计费尚未支持。美元金额以百万分之一美元整数存储，每次费用向上取整。发起请求前，以消息 UTF-8 字节和输出上限预估额度；实际费用以返回的用量为准，极端情况下余额可能为负，后续调用会被阻止。

每个账户一次只处理一个请求。上游超时、错误或未返回完整用量时，不自动扣客户额度，账户进入待核账状态，由管理员核对上游账单后处理。不要盲目重试，以免重复生成。

避免重复请求

建议每次独立调用发送唯一的 Idempotency-Key（8至128位可打印ASCII字符）。相同账户重复使用同一值会返回409，并附上原调用编号，不会再次请求上游。系统不缓存和重放模型正文；遇到409请查询调用记录，确认后才能用新编号发起新调用。

当前支持范围

仅支持文本 system/user/assistant 消息、max_tokens 和非流式 Chat Completions。暂不支持流式输出、工具调用、图片、文件、在线银行卡付款或订阅，也不保证所有客户端即插即用。

常见状态码：401 密钥无效；402 额度不足或有待结算请求；429 请求过多；502 上游异常待核账；503 未配置上游；409 重复请求。