DEVELOPER DOCS

API 文档

OpenAI 兼容 Chat Completions。鉴权用 Bearer Key,Base URL 为当前域名。公开读模型列表;付费推理须 L2(手机验证 + 个人/企业实名)。

Base URL Header Authorization: Bearer sk-… 付费调用须 L2

快速开始

一条 POST 即可对话。SDK 把 base_url 指到本站 /v1,模型名用广场里的 id,演示走 bilzatos-mock。


            

Key 在 个人中心 创建。未完成 L2 不得开通生产 Key、充值或付费推理。

鉴权

所有付费推理请求在 Header 携带:

Authorization: Bearer sk-YOUR_KEY
要求说明
L0可浏览文档、模型广场、状态页
L1 手机验证码登录后进入控制台,仍不可充值/付费推理
L2 实名个人或企业实名且后台审核通过后,才可充值、开生产 Key、调用 Chat Completions

Chat Completions

与 OpenAI Chat Completions 对齐。成功时读 choices[0].message.content;额外字段 bilzatos.latency_ms 给出本站实测延迟。

POST/v1/chat/completions

请求体

字段类型说明
model必填string模型 id,演示用 bilzatos-mock
messages必填array对话轮次;取最后一条 content 作为本次 prompt
messages[].role可选stringuser / system / assistant
messages[].content必填string文本内容
max_tokens可选integer默认 64

成功响应(节选)

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "bilzatos-mock",
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "…" }, "finish_reason": "stop" }],
  "usage": { "prompt_tokens": 1, "completion_tokens": 8, "total_tokens": 9 },
  "bilzatos": { "latency_ms": 12, "mode": "mock" }
}

Models

公开列表,无需 Key。与模型广场同源。

GET/v1/models

          
id名称owned_by状态
加载中…

错误码

HTTP 状态与 error 字段同时给出,便于 SDK 分支处理。

HTTPerror含义
401invalid_api_key缺少或错误的 Bearer Key
403l2_required未完成手机 + 实名,禁止推理
402insufficient_balance余额不足,先 L2 再充值
404not_found路径不存在

限额与计费

按 Token 从余额扣减,¥0.02 / 千 Token,单次最低 ¥0.01。无演示模式抬高等级。详见 定价。

在线试跑

Key 仅留在本机浏览器,请求直达本站。未 L2 或余额不足会原样返回错误 JSON。

去控制台拿 Key
响应会出现在这里