文档
API 参考
Gemini

Gemini

POSThttps://api.airoutly.com/v1beta/models/{model}:generateContent

Google 原生接口，用于调用 Gemini 模型，Google Gen AI SDK 与 Gemini CLI 使用。路径和请求体与 Google 官方一致，只需更换域名。

认证

用 x-goog-api-key: <key>（Google SDK 的默认方式）、?key=<key> 或 Authorization: Bearer <key> 发送 Key 均可。

请求参数

参数	说明
`{model}`path必填	模型页上的 Gemini 模型 ID，例如 `gemini-2.5-flash`。
`contents`array必填	对话内容：每项包含 `role` 和 `parts`（文本、内联图片、音频或视频）。
`systemInstruction`object	系统提示词。
`generationConfig`object	`temperature`、`maxOutputTokens` 等生成参数，字段名统一用小驼峰。

请求示例

curl "https://api.airoutly.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $AIROUTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello"}]}]}'

import os
from google import genai
from google.genai import types

client = genai.Client(
    api_key=os.environ["AIROUTLY_API_KEY"],
    http_options=types.HttpOptions(base_url="https://api.airoutly.com"),
)
resp = client.models.generate_content(model="gemini-2.5-flash", contents="Hello")
print(resp.text)

使用 Google Gen AI SDK 时，把 base URL 设为 https://api.airoutly.com，SDK 会自己拼上 /v1beta/models/...。

流式响应

把 :generateContent 换成 :streamGenerateContent?alt=sse。

curl

curl "https://api.airoutly.com/v1beta/models/gemini-2.5-flash:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: $AIROUTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Tell me a story"}]}]}'