API 参考
基础信息
| 项目 | 说明 |
|---|---|
| 基础 URL | https://api.tokenclub.cc |
| 认证方式 | Bearer Token (Authorization: Bearer YOUR_API_KEY) |
| 数据格式 | JSON |
| 字符编码 | UTF-8 |
| 请求方法 | POST |
聊天完成接口 (Chat Completions)
接口地址
POST /v1/chat/completions请求头 (Headers)
| 参数 | 值 | 必填 |
|---|---|---|
| Authorization | Bearer YOUR_API_KEY | 是 |
| Content-Type | application/json | 是 |
请求体 (Request Body)
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
| model | string | 是 | 模型名称（参考模型广场） | - |
| messages | array | 是 | 消息数组 | - |
| temperature | float | 否 | 采样温度 (0-2) | 1.0 |
| max_tokens | int | 否 | 最大生成 token 数 | 4096 |
| top_p | float | 否 | 核采样概率 (0-1) | 1.0 |
| stream | bool | 否 | 是否流式返回 | false |
| frequency_penalty | float | 否 | 频率惩罚 (-2 to 2) | 0 |
| presence_penalty | float | 否 | 存在惩罚 (-2 to 2) | 0 |
| stop | array/string | 否 | 停止序列 | null |
messages 格式
{
"messages": [
{"role": "system", "content": "你是一个有帮助的助手"},
{"role": "user", "content": "你好"},
{"role": "assistant", "content": "你好！有什么可以帮助你的吗？"},
{"role": "user", "content": "请介绍一下你自己"}
]
}响应示例 (Response)
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1677652288,
"model": "gpt-4o",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我是 TokenClub AI 助手..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 50,
"total_tokens": 70
}
}流式响应 (Streaming)
stream: true 可获得流式响应：data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"Hello"},"index":0,"finish_reason":null}]}
data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"!"},"index":0,"finish_reason":null}]}
data: {"id":"chatcmpl-xxx","choices":[{"delta":{},"index":0,"finish_reason":"stop"}]}
data: [DONE]模型列表接口 (Models)
接口地址
GET /v1/models响应示例
{
"object": "list",
"data": [
{
"id": "gpt-4o",
"object": "model",
"created": 1677610602,
"owned_by": "openai"
},
{
"id": "gpt-4o-mini",
"object": "model",
"created": 1687888000,
"owned_by": "openai"
}
]
}错误码 (Error Codes)
| 错误码 | HTTP 状态码 | 说明 |
|---|---|---|
| 400 | 400 | 请求参数错误 |
| 401 | 401 | API Key 无效或已过期 |
| 403 | 403 | 权限不足 |
| 404 | 404 | 接口或模型不存在 |
| 429 | 429 | 请求频率超限 (Rate Limit) |
| 500 | 500 | 服务器内部错误 |
| 503 | 503 | 服务暂时不可用 |
错误响应示例
{
"error": {
"message": "Invalid API Key",
"type": "invalid_request_error",
"code": 401
}
}余额查询接口 (Balance)
接口地址
GET /v1/user/balance请求头
| 参数 | 值 | 必填 |
|---|---|---|
| Authorization | Bearer YOUR_API_KEY | 是 |
响应示例
{
"balance": {
"total": 10.00,
"available": 8.50,
"used": 1.50,
"currency": "USD"
}
}修改于 2026-04-11 12:02:50