快速開始

使用 API 金鑰與模型將你的首個應用程式連接到網關。

建立 API 金鑰

在主控台開啟【API 金鑰】頁面，建立具備足夠額度且擁有目標模型權限的金鑰。將後續範例中的 YOUR_API_KEY 替換為你實際的金鑰。

可用模型

模型列表反映的是目前金鑰與群組的存取權限，並不代表相容所有介面類型。在呼叫具體模型 ID 前，請查閱其 supported_endpoint_types 與官方模型文件。部分模型可能僅支援 Responses、圖像或其他特定介面。

curl 'https://routerra.ai/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

發送請求

向對話補全端點發送請求。將 YOUR_MODEL_ID 替換為你金鑰支援的實際模型名稱。

curl 'https://routerra.ai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

常見問題排查

若遇認證錯誤，請檢查金鑰正確性與有效期限；若遇額度錯誤，請確認帳戶餘額與金鑰額度；若模型無法使用，請核對模型 ID 與群組權限；若遇速率限制，請採取指數退避重試。