建立對話請求 (OpenAI)

簡介

通用文字對話介面，支援 OpenAI 相容的大型語言模型生成對話回覆。透過統一的 API 介面，您可以呼叫 OpenAI、Claude、DeepSeek、Grok、通義千問等多個主流大型模型。

認證

Bearer Token，如 Bearer sk-xxxxxxxxxx

請求參數

model

string

required

模型識別碼，支援的模型包括：

OpenAI 系列：gpt-4o、gpt-4o-mini、o3-mini、o4-mini 等
Claude 系列：claude-opus-4-6、claude-sonnet-4-5-20250929 等
DeepSeek 系列：deepseek-v3、deepseek-r1 等
Gemini 系列：gemini-3-pro-preview、gemini-3-flash-preview 等
國產模型：glm-5、kimi-k2.5、doubao-seed-1-8-251228 等

messages

array

required

對話訊息列表，每個元素包含 role（user/system/assistant）和 content

temperature

number

隨機性控制，0-2，數值越高回覆越隨機

stream

boolean

是否啟用串流輸出，回傳 SSE 格式的分片資料

max_tokens

integer

最大生成 token 數，控制回覆長度

基礎範例

非串流請求
串流請求（SSE）
Python 範例

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "system", "content": "你是一個有用的助手"},
      {"role": "user", "content": "請用中文簡要介紹人工智慧"}
    ],
    "temperature": 0.7
  }'

curl -N -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "doubao-seed-1-8-251228",
    "stream": true,
    "messages": [
      {"role": "system", "content": "你是一個有用的助手"},
      {"role": "user", "content": "請用中文簡要介紹人工智慧"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://console.mixroute.io/v1"
)

# 非串流
completion = client.chat.completions.create(
    model="glm-5",
    messages=[
        {"role": "system", "content": "你是一個有用的助手"},
        {"role": "user", "content": "請用中文簡要介紹人工智慧"}
    ],
    temperature=0.7
)
print(completion.choices[0].message.content)

# 串流
stream = client.chat.completions.create(
    model="doubao-seed-1-8-251228",
    messages=[
        {"role": "user", "content": "請用中文簡要介紹人工智慧"}
    ],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

進階功能

支援 OpenAI 相容的工具呼叫格式：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "user", "content": "上海的天氣怎麼樣？"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "根據城市取得天氣資訊",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {"type": "string"}
            },
            "required": ["city"]
          }
        }
      }
    ],
    "tool_choice": "auto"
  }'

使用 JSON Schema 約束模型輸出格式：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-4o",
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "Answer",
        "schema": {
          "type": "object",
          "properties": {
            "summary": {"type": "string"}
          },
          "required": ["summary"]
        }
      }
    },
    "messages": [
      {"role": "user", "content": "回傳一個包含 summary 欄位的 JSON"}
    ]
  }'

DeepSeek
通義千問
Gemini

DeepSeek R1 系列支援深度思考能力：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "deepseek-r1",
    "messages": [
      {"role": "user", "content": "請分析這道數學題：如果 x^2 + 2x - 3 = 0，求 x 的值"}
    ],
    "temperature": 0.6
  }'

回應將包含 reasoning_content 欄位展示思考過程。

通義千問 QwQ 系列支援思考能力：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "qwq-32b",
    "messages": [
      {"role": "user", "content": "分析一下人工智慧的發展趨勢"}
    ],
    "enable_thinking": true
  }'

Gemini 2.0 Flash Thinking 支援思考能力：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gemini-2.0-flash-thinking-exp",
    "messages": [
      {"role": "user", "content": "解釋量子計算的基本原理"}
    ]
  }'

通義千問支援額外的擴展參數：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "qwen-max",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "enable_search": true,
    "search_options": {
      "search_strategy": "standard",
      "forced_search": false
    }
  }'

參數	說明
`enable_search`	啟用聯網搜尋
`search_options.search_strategy`	搜尋策略：`standard`/`pro`
`search_options.forced_search`	強制搜尋

Claude 搜尋
Grok 搜尋

Claude 模型支援聯網搜尋功能：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [
      {"role": "user", "content": "今天有什麼重大新聞？"}
    ],
    "tools": [
      {
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 5
      }
    ]
  }'

Grok 模型支援即時聯網搜尋：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "grok-3",
    "messages": [
      {"role": "user", "content": "最新的科技新聞有哪些？"}
    ],
    "search_parameters": {
      "mode": "auto",
      "return_citations": true
    }
  }'

GPT 模型支援直接處理檔案內容：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "請分析這個文件的內容"},
          {
            "type": "file",
            "file": {
              "url": "https://example.com/document.pdf"
            }
          }
        ]
      }
    ]
  }'

支援的檔案類型包括 PDF、Word、Excel、圖片等。

Grok 模型支援增強推理能力：

curl -X POST "https://console.mixroute.io/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "grok-3-mini",
    "messages": [
      {"role": "user", "content": "分析以下邏輯問題：如果所有A都是B，且所有B都是C，那麼..."}
    ],
    "reasoning_effort": "high"
  }'

reasoning_effort	說明
`low`	快速回應，基礎推理
`medium`	平衡模式
`high`	深度推理，更精確

回應格式

非串流回應
串流回應

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "glm-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "回覆內容..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 100,
    "total_tokens": 125
  }
}

串流回應使用 Server-Sent Events (SSE) 格式：

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1234567890,"model":"gpt-4o","choices":[{"index":0,"delta":{"role":"assistant","content":"你"},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1234567890,"model":"gpt-4o","choices":[{"index":0,"delta":{"content":"好"},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1234567890,"model":"gpt-4o","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

每個 chunk 包含增量內容，最後以 [DONE] 結束。

錯誤處理

異常類型	觸發情境
AuthenticationError	API 金鑰無效或未授權
NotFoundError	模型不存在或不被支援
APIConnectionError	網路中斷或伺服器未回應
RateLimitError	請求頻率超限

curl --request POST \
  --url https://console.mixroute.io/v1/chat/completions \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "glm-5",
    "messages": [
      {"role": "system", "content": "你是一個有用的助手"},
      {"role": "user", "content": "請用中文簡要介紹人工智慧"}
    ],
    "temperature": 0.7
  }'

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "glm-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工智慧是研究、開發用於模擬、延伸和擴展人的智慧的理論、方法、技術及應用系統的一門新的技術科學..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 100,
    "total_tokens": 125
  }
}

當下熱門模型

OpenAI 官方庫使用

文本系列

文本向量系列

圖像系列

視頻系列

其他

建立對話請求 (OpenAI)

簡介

認證

請求參數

基礎範例

進階功能

回應格式

錯誤處理

當下熱門模型

OpenAI 官方庫使用

文本系列

文本向量系列

圖像系列

視頻系列

其他

​簡介

​認證

​請求參數

​基礎範例

​進階功能

​回應格式

​錯誤處理

簡介

認證

請求參數

基礎範例

進階功能

回應格式

錯誤處理