认证方式
所有API请求必须在HTTP请求头中携带身份认证信息。平台使用Bearer Token方式进行鉴权。
# 在请求头中添加
Authorization: Bearer $YOUR_API_KEY
Content-Type: application/json
API密钥在账号开通后由平台分配,请妥善保管,不要泄露给第三方。如怀疑密钥泄露,可联系商务重置。
对话接口
平台提供大模型对话补全接口,兼容主流大模型请求格式。
POST https://api.lstokenhub.com/v1/chat/completions
请求示例
curl https://api.lstokenhub.com/v1/chat/completions \
-H "Authorization: Bearer $YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": "你是一个 helpful 的助手"},
{"role": "user", "content": "你好,请介绍一下你自己"}
],
"stream": false
}'
请求参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 目标模型名称,如 deepseek-chat、qwen-plus 等 |
| messages | array | 是 | 对话消息列表,包含 role 和 content |
| messages[].role | string | 是 | 消息角色:system / user / assistant |
| messages[].content | string | 是 | 消息内容文本 |
| stream | boolean | 否 | 是否流式返回,默认 false |
| temperature | number | 否 | 采样温度,控制输出随机性,0-2之间 |
| max_tokens | integer | 否 | 限制返回内容的最大长度 |
返回格式
请求成功后,平台返回标准JSON格式响应:
{
"id": "chatcmpl-xxx",
"model": "deepseek-chat",
"choices": [
{
"message": {
"role": "assistant",
"content": "你好!我是..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 150,
"total_tokens": 170
}
}
错误码说明
| HTTP状态码 | 含义 | 处理建议 |
|---|---|---|
| 200 | 请求成功 | 正常处理返回结果 |
| 400 | 请求参数错误 | 检查请求格式与参数是否合法 |
| 401 | 认证失败 | 检查API Key是否正确、是否过期 |
| 429 | 请求频率超限 | 降低请求频率或联系商务提升限额 |
| 500 | 服务器内部错误 | 稍后重试,多次失败联系技术支持 |
| 503 | 上游模型服务暂不可用 | 平台会自动切换备用通道,如持续失败请联系支持 |
可用模型列表
通过修改 model 参数即可切换不同模型,当前可用模型包括:
- deepseek-chat — DeepSeek 通用对话模型
- qwen-plus — 通义千问增强版
- glm-4 — 智谱清言 GLM-4
- moonshot-v1 — Kimi 长上下文模型
- abab — MiniMax 对话模型
完整模型清单及各模型参数上限,请查看模型服务页面或联系商务获取最新目录。