Documentation

API reference
POST/v1/chat/completions

Create Chat Completion

Creates a model response from conversation history with streaming, tools, and usage accounting.

ProtocolOpenAI Chat Completions
Reference category聊天

Compatible model examples

gpt-4ogpt-4.1gpt-5o3o4-mini
Keep the format. Choose your model.
cURL
curl -X POST https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello from Route Key"
    }
  ],
  "stream": false
}'
Example only · no request is sent
參數
Name類型必填Description
modelstring是模型名稱
messagesarray<object>是聊天
temperaturenumber否Temperature
top_pnumber否Top P
streamboolean否即時
max_tokensinteger否Max tokens
toolsarray<object>否Tools
response_formatobject否Response format
回應
Name類型必填Description
idstring-ID
objectstring-Object
createdinteger-Created
modelstring-模型名稱
choicesarray<object>-Choices
usageobject-Usage
備註
  • OpenAI Chat Completions
  • Use the same request shape as the matching provider API when the backend channel is enabled.
Your applicationRouteKeyOpenAI

核心概念

核心概念

API 金鑰: API 金鑰

Base URL: Route Key 保留 OpenAI 格式,只改變 SDK 發送位置。

模型名稱: 模型名稱保留在 payload 中,由後端決定路由。

用量與帳務: 成本、Token 與延遲會顯示在用量記錄中。

模型選擇

模型選擇

一般聊天: 一般聊天

推理或程式碼: 推理或程式碼

推理或程式碼

用量與帳務

常見錯誤

首次失敗多半來自驗證、模型、額度或請求格式。

401

驗證

驗證

403

用量與帳務

模型名稱保留在 payload 中,由後端決定路由。

429

用量與帳務

成本、Token 與延遲會顯示在用量記錄中。

5xx

常見錯誤

首次失敗多半來自驗證、模型、額度或請求格式。