API 文档
Chat Completions API
对话补全 API 接口说明
概述
Chat Completions API 是最常用的接口，用于与 AI 模型进行对话。
POST https://api.smai.ai/v1/chat/completions请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，如 gpt-4.1 |
| messages | array | 是 | 对话消息列表 |
| temperature | number | 否 | 采样温度，0-2，默认 1 |
| max_tokens | integer | 否 | 最大生成 Token 数 |
| stream | boolean | 否 | 是否流式输出，默认 false |
| top_p | number | 否 | 核采样参数，0-1 |
messages 格式
[
{ "role": "system", "content": "You are a helpful assistant." },
{ "role": "user", "content": "Hello!" },
{ "role": "assistant", "content": "Hi! How can I help you?" },
{ "role": "user", "content": "What is 2+2?" }
]角色说明：
system: 系统提示，设定 AI 的行为user: 用户消息assistant: AI 的回复
请求示例
curl https://api.smai.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "gpt-4.1",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
],
"temperature": 0.7,
"max_tokens": 1000
}'响应格式
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-4.1",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! How can I assist you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 10,
"total_tokens": 30
}
}流式输出
设置 stream: true 启用流式输出：
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.smai.ai/v1"
)
stream = client.chat.completions.create(
model="gpt-4.1",
messages=[{"role": "user", "content": "写一首诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")支持的模型
Chat Completions API 支持大多数模型，包括：
- GPT 系列:
gpt-4.1,gpt-4o,gpt-4-turbo - Claude 系列:
claude-4.5-sonnet,claude-opus-4 - Gemini 系列:
gemini-3-pro,gemini-2.5-flash - DeepSeek:
deepseek-chat - 更多模型请查看 模型列表
注意
推理模型（如 gpt-5.2-pro, o3-pro）需要使用 Responses
API。