接口文档
完全兼容 OpenAI 协议,任何 OpenAI SDK 改 base_url 即可。
接口地址
—鉴权
在请求头带你的密钥,两种写法都支持:
Authorization: Bearer sk-xxxxxxxx
# 或
x-api-key: sk-xxxxxxxx
对话补全
POST /v1/chat/completions
Content-Type: application/json
{
"model": "kilo-auto/free",
"messages": [
{"role": "system", "content": "你是一个助手"},
{"role": "user", "content": "你好"}
],
"stream": false
}
curl
curl —/chat/completions \
-H "Authorization: Bearer 你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"kilo-auto/free","messages":[{"role":"user","content":"你好"}]}'
Python(官方 SDK)
from openai import OpenAI
client = OpenAI(
api_key="你的密钥",
base_url="—",
)
resp = client.chat.completions.create(
model="kilo-auto/free",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "你的密钥",
baseURL: "—",
});
const resp = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
流式输出
stream = client.chat.completions.create(
model="kilo-auto/free",
messages=[{"role": "user", "content": "讲个笑话"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
模型列表
GET /v1/models
错误码
| 状态码 | 含义 | 处理 |
|---|---|---|
| 401 | 密钥无效或已禁用 | 检查密钥 |
| 402 | 余额不足 | 充值或兑换 |
| 429 | 触发限流 / 日额度用尽 | 降速或次日重试 |
| 404 | 模型不存在 | 查 /v1/models |
| 502/503 | 上游全部不可用 | 稍后重试 |
计费说明
按输入/输出 token 分别计价,单位「元 / 百万 token」。每次调用结束后从余额扣除,用量明细在「用量账单」页可查。