🎁 新用戶 免費註冊,送 10 次呼叫,最高 $1,免綁卡。

快速開始

在 2 分鐘內開始使用 Synthorai。

1. 取得你的 API Key

登入並前往 Console → API Keys. 點擊 "建立金鑰" 並立即複製——它只會顯示一次。

2. 發出你的第一個請求

選擇你已經在用的 SDK。兩種範例都使用同一個 API key 存取同一個 gateway。

方案 A —— OpenAI SDK

curl https://synthorai.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "Hello! What can you do?"}
    ]
  }'

方案 B —— Anthropic SDK

curl https://synthorai.io/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Hello! What can you do?"}
    ]
  }'

Anthropic SDK 會在內部追加 /v1/messages 。請使用 gateway origin(不帶 /v1 後綴)作為 base_url ——這與接受 https://synthorai.io/v1.

3. 列出可用模型

curl https://synthorai.io/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

模型 ID 遵循原始供應商使用的格式。你可以透過以下方式取得完整清單: /v1/models 端點,或造訪 模型目錄 頁面。

使用工具而非原始 SDK?

如果你要將 Synthorai 接入 Claude Code、OpenAI Codex CLI、OpenClaw、Cursor、Continue、Aider 或任何其他 OpenAI/Anthropic 相容的工具——我們為三大主流工具各提供了專門的設定頁面,並為其餘工具提供了一份 base URL 速查表。

驗證

所有 API 請求都需要在以下位置傳入 API 金鑰: Authorization 請求標頭中傳入。

Bearer Token

Authorization: Bearer YOUR_API_KEY

金鑰權限範圍

參數類型說明
Readstring僅可存取模型清單與用量資料。
Writestring發起推理請求(chat、completions)。
Adminstring完整存取權限,包括通道與使用者管理。

切勿在用戶端程式碼或公開儲存庫中暴露你的 API 金鑰。若金鑰外洩,請立即透過以下位置輪換: Console → API 金鑰.

金鑰格式

Synthorai 金鑰以以下前綴開頭: sk- 後接一個隨機的 32 字元字串。金鑰在儲存時經過雜湊處理,建立後無法復原。

不確定從哪個模型開始?瀏覽 model price comparison 即可並排查看每個可路由模型的按 token 價格。