Appearance
三、API 配置使用指南
API 接口地址（重要，配置必读！）
推荐主接口地址
https://panel.tokenallin.com/v1所有请求路径遵循 OpenAI 兼容格式：
| 端点 | 用途 |
|---|---|
POST /v1/chat/completions | 对话生成（最常用） |
GET /v1/models | 列出可用模型 |
POST /v1/embeddings | 文本向量化 |
认证方式：
Authorization: Bearer sk-your-token请求示例（cURL）
非流式
bash
curl https://panel.tokenallin.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-token" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{"role": "user", "content": "你好，介绍一下自己"}
]
}'流式（SSE）
bash
curl -N https://panel.tokenallin.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-token" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role":"user","content":"讲个笑话"}],
"stream": true
}'工具调用
bash
curl https://panel.tokenallin.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-token" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role":"user","content":"北京现在几点？"}],
"tools": [{
"type": "function",
"function": {
"name": "get_time",
"description": "获取指定城市当前时间",
"parameters": {
"type": "object",
"properties": {
"city": {"type":"string"}
},
"required": ["city"]
}
}
}]
}'常用参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 模型 ID（见 模型广场） |
messages | array | 消息数组 |
stream | bool | 是否流式返回 |
temperature | float | 0–2，越高越随机，默认 1 |
max_tokens | int | 最大生成长度 |
top_p | float | 核采样，默认 1 |
tools | array | 可用工具列表 |
response_format | object | 结构化输出（JSON mode） |
响应格式
json
{
"id": "chatcmpl-xxxxx",
"object": "chat.completion",
"created": 1713427200,
"model": "claude-sonnet-4-6",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我是..."
},
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 15,
"completion_tokens": 42,
"total_tokens": 57
}
}错误码
| HTTP | 含义 | 常见原因 |
|---|---|---|
| 400 | 请求格式错 | JSON 语法错误、必填字段缺失 |
| 401 | 认证失败 | Key 无效/已删除/已禁用 |
| 402 | 余额不足 | 账户余额 ≤ 0，需充值 |
| 403 | 模型无权限 | Key 白名单未包含此模型 |
| 429 | 触发限流 | 并发过高，稍后重试 |
| 500 | 上游异常 | 模型提供商故障，自动故障转移 |
| 502 | 网关错误 | 服务重启或维护 |