API 參考
Chat Completions
POST https://api.flyrouter.ai/v1/chat/completions
OpenAI 相容的對話補全介面，可以呼叫全部文字模型（Claude、GPT、Gemini、Grok、DeepSeek 等），請求和回應格式與 OpenAI 官方一致。
請求範例
終端機
curl https://api.flyrouter.ai/v1/chat/completions \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{"role": "system", "content": "你是一個簡潔的助理。"},
{"role": "user", "content": "什麼是向量資料庫？"}
],
"max_tokens": 1024
}'請求參數
| 參數 | 型別 | 說明 |
|---|---|---|
model | string | 必填。模型 ID，見 模型列表 |
messages | array | 必填。對話訊息，role 為 system、user、assistant 或 tool |
stream | boolean | 是否串流回傳，見 串流輸出 |
stream_options | object | 串流時設 {"include_usage": true}，最後一個區塊回傳用量 |
max_tokens / max_completion_tokens | integer | 最多生成的 token 數 |
temperature / top_p | number | 取樣參數。部分新模型（如新款 Claude、推理模型）不支援，傳入會被拒絕或忽略 |
stop | string / array | 遇到這些字串時停止生成 |
tools / tool_choice | array / string | 工具呼叫 |
response_format | object | 結構化輸出 |
reasoning_effort | string | GPT 推理深度：low、medium、high，見 深度思考 |
訊息內容可以是字串，也可以是內容區塊陣列（文字、image_url 圖片），見 圖片理解。
回應
json
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1761800000,
"model": "gpt-6.1-sol",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "向量資料庫是……" },
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 26,
"completion_tokens": 182,
"total_tokens": 208,
"prompt_tokens_details": { "cached_tokens": 0 }
}
}finish_reason 的常見取值：stop（正常結束）、length（達到 max_tokens 被截斷）、tool_calls（模型請求呼叫工具）。
用 Chat Completions 呼叫 Claude
可以，但只適合簡單對話。提示詞快取、深度思考等 Claude 專有能力在 OpenAI 格式下可能無法使用或效果打折，需要這些能力時請改用 Messages。
FlyRouter