對話補全
給定一段由多条消息组成的對話，模型會返回一個響應。
POST https://api.linkastra.ai/v1/chat/completions請求體
| 參數 | 類型 | 必填 | 默认值 | 說明 |
|---|---|---|---|---|
model | string | 是 | — | 模型 ID（例如 deepseek/deepseek-v4-pro、z-ai/glm-5.1） |
messages | array | 是 | — | 消息對象列表 |
temperature | float | 否 | 1.0 | 採样随機性（0–2） |
top_p | float | 否 | 1.0 | 核採样阈值 |
max_tokens | integer | 否 | 模型最大值 | 生成的最大 token 數 |
stream | boolean | 否 | false | 通過 SSE 流式返回部分結果 |
stop | string/array | 否 | null | 最多 4 個停止序列 |
presence_penalty | float | 否 | 0 | 基於存在性對新 token 进行惩罚（-2–2） |
frequency_penalty | float | 否 | 0 | 基於频率對新 token 进行惩罚（-2–2） |
response_format | object | 否 | null | 啓用 JSON 模式或結構化輸出 |
tools | array | 否 | null | 函數/工具定義列表 |
tool_choice | string/object | 否 | auto | 控制工具選擇行為 |
seed | integer | 否 | null | 用於確定性採样 |
n | integer | 否 | 1 | 生成的補全數量 |
消息對象
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
role | string | 是 | system、user、assistant 或 tool |
content | string/array | 是 | 消息內容（字符串或內容片段） |
name | string | 否 | 發送者名稱（用於 user/tool 角色） |
tool_calls | array | 否 | 助手發起的工具調用 |
tool_call_id | string | 否 | 工具調用的 ID（用於 tool 角色） |
請求示例
curl https://api.linkastra.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v4-pro",
"messages": [
{"role": "system", "content": "You are a helpful coding assistant."},
{"role": "user", "content": "Write a Python function to reverse a linked list."}
],
"temperature": 0.3,
"max_tokens": 1024
}'響應
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1719000000,
"model": "deepseek/deepseek-v4-pro",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Here's a Python function to reverse a linked list..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 150,
"total_tokens": 180
}
}
```bash
### 結束原因
| 原因 | 說明 |
|--------|-------------|
| `stop` | 模型自然結束或命中停止序列 |
| `length` | 在完成前已達到最大 token 數 |
| `content_filter` | 內容被安全策略過滤 |
| `tool_calls` | 模型希望調用工具 |
## 流式響應
設定 `stream: true` 即可接收 SSE 數據块。详见[流式響應](../getting-started/streaming-response)。
## 配合 OpenAI SDK 使用
```python
from openai import OpenAI
client = OpenAI(
base_url="https://api.linkastra.ai/v1",
api_key="YOUR_API_KEY"
)
response = client.chat.completions.create(
model="deepseek/deepseek-v4-pro",
messages=[
{"role": "user", "content": "Hello!"}
]
)支援的模型
完整可用的模型 ID 列表請见模型概览。