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": "你好!"}]
}'
任何 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 的工具。
POST /api/v1/chat/completions(需要 API Key)
model — 模型 ID,见 模型市场,如 openai/gpt-5.1messages — 消息数组,与 OpenAI 格式一致(含 system/user/assistant/tool)stream — 是否流式,默认 falsetemperature、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)。
所有计费接口使用 Authorization: Bearer sk-ebtc-v1-…。Key 仅在创建时显示一次,请妥善保存。每个 Key 可单独设置 RPM 限速,可随时在控制台禁用或吊销。GET /api/v1/auth/key 可查询当前 Key 的用量与限额。
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=… | 生成内容(需站点开启留存) |
| HTTP | code | 含义 |
|---|---|---|
| 400 | invalid_request_error | 参数缺失或非法 |
| 401 | missing_api_key / invalid_api_key | 未携带 / 无效的 API Key |
| 402 | insufficient_credits | 余额不足,请充值 |
| 403 | account_disabled | 账户被禁用 |
| 404 | model_not_found | 模型不存在或未启用 |
| 429 | rate_limit_exceeded | 超出 Key 速率限制 |
| 503 | no_provider_available | 该模型暂无可用服务商端点 |
| 502 | upstream_error / upstream_unreachable | 上游故障(网关已自动尝试切换) |
在 控制台 → 设置绑定你自己的上游服务商密钥后,命中该服务商的请求将直接使用你的密钥调用上游,仅收取小额服务费(默认 5%),路由、统计、Key 管理能力全部保留。