Appearance
Chat Completions
Chat Completions 是最常用的对话补全接口,兼容 OpenAI 风格请求格式。
接口地址
text
POST /v1/chat/completions主入口完整地址:
text
https://kktyh.com/v1/chat/completions请求示例
bash
curl https://kktyh.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model-name",
"messages": [
{ "role": "system", "content": "你是一个简洁、可靠的技术助手。" },
{ "role": "user", "content": "写一个简短的产品介绍。" }
],
"stream": false
}'流式输出
支持流式输出的模型可以设置:
json
{
"stream": true
}客户端需要按 Server-Sent Events 或兼容 OpenAI SDK 的方式读取增量结果。
常见错误
| 状态码 | 常见原因 | 处理方式 |
|---|---|---|
401 | API Key 缺失、错误或已删除 | 检查 Authorization 头 |
404 | 模型名称不存在或不可用 | 在模型列表中确认模型名称 |
429 | 额度不足或触发频率限制 | 检查额度、降低并发或稍后重试 |
500 | 上游模型或线路异常 | 稍后重试,或切换可用模型 |