接口文档

完全兼容 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」。每次调用结束后从余额扣除,用量明细在「用量账单」页可查。