API 參考

generateContent

POST https://api.flyrouter.ai/v1beta/models/{model}:generateContent

POST https://api.flyrouter.ai/v1beta/models/{model}:streamGenerateContent?alt=sse

Gemini 原生介面,請求和回應格式與 Google Gemini API 一致,適合已經在用 Google Gen AI SDK 或 Gemini CLI 的專案。

請求範例

curl "https://api.flyrouter.ai/v1beta/models/gemini-4-argon:generateContent" \
  -H "x-goog-api-key: $FLYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {"parts": [{"text": "你是一個簡潔的助理。"}]},
    "contents": [
      {"role": "user", "parts": [{"text": "用一句話介紹你自己"}]}
    ],
    "generationConfig": {"maxOutputTokens": 1024}
  }'

串流

使用 streamGenerateContent 並帶上 alt=sse,回應為 SSE,每個事件是一個部分結果:

終端機
curl "https://api.flyrouter.ai/v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: $FLYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -N \
  -d '{"contents": [{"role": "user", "parts": [{"text": "寫一首關於秋天的短詩"}]}]}'

驗證

x-goog-api-key: sk-... 或 Authorization: Bearer sk-... 均可。不建議把 Key 放進 URL 參數,URL 容易被日誌記錄。

回應

json
{
  "candidates": [
    {
      "content": { "role": "model", "parts": [{ "text": "我是……" }] },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 30,
    "totalTokenCount": 42
  }
}

:countTokens 暫不支援。只想用 OpenAI SDK 的話,Gemini 模型也可以直接透過 Chat Completions 呼叫。

FlyRouter

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