接口简介
本服务兼容 OpenAI 接口格式,可直接使用 OpenAI SDK 或任意兼容客户端接入。
基础地址:https://aiapi.tbit.top/api.php
认证方式:在请求头中携带 Authorization: Bearer 你的密钥
密钥在控制台获取,注册即送 20 余额,按实际 Token 用量计费。
接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /v1/models | 获取可用模型列表 |
POST | /v1/chat/completions | 对话补全(支持流式) |
完整 URL 示例:https://aiapi.tbit.top/api.php/v1/chat/completions
1. 获取模型列表
GET https://aiapi.tbit.top/api.php/v1/models
需要携带 Authorization 头。
curl https://aiapi.tbit.top/api.php/v1/models \
-H "Authorization: Bearer sk-你的密钥"
返回格式:
{
"object": "list",
"data": [
{
"id": "模型ID",
"object": "model",
"created": 1700000000,
"owned_by": "organization"
}
]
}
2. 对话补全
POST https://aiapi.tbit.top/api.php/v1/chat/completions
请求体参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,从模型列表获取 |
messages | array | 是 | 对话消息数组 |
stream | boolean | 否 | 是否流式输出,默认 false |
temperature | float | 否 | 温度参数,默认 1 |
max_tokens | int | 否 | 最大输出 Token 数 |
curl 示例:
curl https://aiapi.tbit.top/api.php/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "模型ID",
"messages": [
{"role": "user", "content": "你好"}
]
}'
流式输出示例:
curl https://aiapi.tbit.top/api.php/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "模型ID",
"messages": [
{"role": "user", "content": "你好"}
],
"stream": true
}'
3. Python 示例
使用 OpenAI SDK:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://aiapi.tbit.top/api.php/v1"
)
response = client.chat.completions.create(
model="模型ID",
messages=[
{"role": "user", "content": "你好"}
]
)
print(response.choices[0].message.content)
# 流式输出
stream = client.chat.completions.create(
model="模型ID",
messages=[{"role": "user", "content": "你好"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
4. JavaScript 示例
const response = await fetch("https://aiapi.tbit.top/api.php/v1/chat/completions", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer sk-你的密钥"
},
body: JSON.stringify({
model: "模型ID",
messages: [{ role: "user", content: "你好" }]
})
});
const data = await response.json();
console.log(data.choices[0].message.content);
错误码说明
| 状态码 | 说明 |
|---|---|
| 401 | 认证失败,密钥缺失或无效 |
| 402 | 余额不足 |
| 404 | 模型不存在或未启用 |
| 400 | 请求参数错误 |
| 502 | 上游服务请求失败 |
计费说明
费用 = (输入 Tokens / 1000) × 输入价格 + (输出 Tokens / 1000) × 输出价格
每个模型的价格在控制台「可用模型」中查看。费用从账户余额中扣除,余额不足时无法调用。