API 文档

Base URL:https://ebtc.top/api/v1

快速开始

1. 注册账号 → 2. 在 控制台创建 API Key → 3. 调用:

curl https://ebtc.top/api/v1/chat/completions \
  -H "Authorization: Bearer sk-ebtc-v1-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-chat",
    "messages": [{"role": "user", "content": "你好!"}]
  }'

SDK 兼容

任何 OpenAI SDK 都能直接使用,只需替换 base_url 与 api_key:

from openai import OpenAI

client = OpenAI(
    base_url="https://ebtc.top/api/v1",
    api_key="sk-ebtc-v1-xxxx",  # 控制台创建的 Key
)

支持的客户端:openai-python、openai-node、LangChain、LlamaIndex、AutoGen、Cline / Roo Code 等一切允许自定义 Base URL 的工具。

Chat Completions

POST /api/v1/chat/completions(需要 API Key)

  • model — 模型 ID,见 模型市场,如 openai/gpt-5.1
  • messages — 消息数组,与 OpenAI 格式一致(含 system/user/assistant/tool)
  • stream — 是否流式,默认 false
  • 其余参数(temperature、top_p、max_tokens、stop、seed、response_format、tools…)原样透传给上游

响应与 OpenAI 完全一致,另有两处增强:

  • id 形如 gen-xxxx:chatcmpl-xxxx,冒号前的部分可用于 生成详情查询
  • usage.cost 直接返回本次消耗金额(美元)

流式输出

设置 "stream": true,返回标准 SSE(text/event-stream),格式与 OpenAI 相同,以 data: [DONE] 结束。网关会自动向上游请求 usage,最终 chunk 通常携带 token 统计。

const stream = await client.chat.completions.create({
  model: "z-ai/glm-4.6",
  messages: [{ role: "user", content: "讲个笑话" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

模型列表

GET /api/v1/models(无需 Key)— 返回全部可用模型及定价(单位:美元/token,与 OpenRouter 一致)。
GET /api/v1/models/{slug} — 返回模型详情,含每个服务商端点的状态、优先级与定价。

服务商路由

同一模型可能有多个服务商端点。默认按「优先级升序 → 权重加权随机」选择;失败自动切换到下一端点。你也可以在请求中指定偏好:

{
  "model": "anthropic/claude-sonnet-4.5",
  "provider": {
    "order": ["anthropic", "openrouter"],
    "allow_fallbacks": false
  },
  "messages": [...]
}

工具调用

tools、tool_choice 参数原样透传,支持所有具备工具调用能力的模型(在模型卡片中标记 Tools)。

认证与 Key

所有计费接口使用 Authorization: Bearer sk-ebtc-v1-…。Key 仅在创建时显示一次,请妥善保存。每个 Key 可单独设置 RPM 限速,可随时在控制台禁用或吊销。GET /api/v1/auth/key 可查询当前 Key 的用量与限额。

额度与计费

  • 费用 = 输入 Token ÷ 1M × 输入单价 + 输出 Token ÷ 1M × 输出单价,模型卡片明码标价
  • 余额不足时返回 402 insufficient_credits,充值后立即恢复
  • 充值:控制台 → 额度 → 兑换充值码
  • GET /api/v1/credits 查询余额与累计消耗;GET /api/v1/activity 查询调用流水

其他接口

方法路径说明
GET/api/v1/models模型列表(公开)
GET/api/v1/models/{id}模型详情与端点(公开)
POST/api/v1/chat/completions对话补全(核心)
GET/api/v1/auth/key当前 Key 信息与用量
GET/api/v1/credits余额与累计消耗
GET/api/v1/activity调用流水(limit/offset)
GET/api/v1/generation?id=…单次生成的费用与 Token 明细
GET/api/v1/generation/content?id=…生成内容(需站点开启留存)

错误码

HTTPcode含义
400invalid_request_error参数缺失或非法
401missing_api_key / invalid_api_key未携带 / 无效的 API Key
402insufficient_credits余额不足,请充值
403account_disabled账户被禁用
404model_not_found模型不存在或未启用
429rate_limit_exceeded超出 Key 速率限制
503no_provider_available该模型暂无可用服务商端点
502upstream_error / upstream_unreachable上游故障(网关已自动尝试切换)

BYOK(自带密钥)

在 控制台 → 设置绑定你自己的上游服务商密钥后,命中该服务商的请求将直接使用你的密钥调用上游,仅收取小额服务费(默认 5%),路由、统计、Key 管理能力全部保留。