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,直飞全球大模型