開發文件

快速開始

幾分鐘內完成串接:建立 API Key,設定環境變數,用你熟悉的語言發出第一個請求。

準備工作

註冊並儲值

在 FlyRouter 控制台 註冊帳戶,到 儲值 頁面儲值。所有模型按實際用量從餘額扣費,沒有月費。

建立 API Key

開啟 API 金鑰 頁面,點選「建立金鑰」。金鑰以 sk- 開頭,只在建立時完整顯示一次,請立即儲存。

寫入環境變數

把金鑰放進環境變數,下文所有範例都從這裡讀取,不要直接寫進程式碼。

終端機
export FLYROUTER_API_KEY="sk-..."

發出第一個請求

下面用 OpenAI SDK 呼叫 gpt-6.1-sol。和呼叫 OpenAI 官方相比,唯一的區別是 Base URL 指向 https://api.flyrouter.ai/v1。

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": "user", "content": "用一句話介紹你自己"}]
  }'

回傳結構與 OpenAI 官方完全一致,回覆文字在 choices[0].message.content,本次用量在 usage 欄位。

呼叫 Claude

呼叫 Claude 推薦使用 Anthropic 官方 SDK(原生 Messages 協定),提示詞快取、深度思考等能力都能完整使用。注意 Anthropic SDK 的 Base URL 不帶 /v1。

# pip install anthropic
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["FLYROUTER_API_KEY"],
    base_url="https://api.flyrouter.ai",
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句話介紹你自己"}],
)
print(msg.content[0].text)

Base URL 帶不帶 /v1

OpenAI SDK 填 https://api.flyrouter.ai/v1(帶 /v1);Anthropic SDK 和 Gemini SDK 填 https://api.flyrouter.ai(不帶 /v1),SDK 會自己補上路徑。填錯是 404 最常見的原因。

下一步

FlyRouter

一組 Key,直飛全球大型模型