Gemini 原生格式调用

参考环境样例中的 Gemini 模型包括 gemini-4-argon、gemini-3.8-flash、gemini-3.1-pro-preview、gemini-2.5-pro 和 gemini-2.5-flash。完整列表以 GET /v1/models 为准。

模型列表

GET https://api.openfde.work/v1beta/models
x-goog-api-key: YOUR_API_KEY

也可以使用 OpenAI-compatible 模型列表：

GET https://api.openfde.work/v1beta/openai/models
Authorization: Bearer YOUR_API_KEY

内容生成

POST https://api.openfde.work/v1beta/models/{model}:generateContent
x-goog-api-key: YOUR_API_KEY
Content-Type: application/json

流式请求把动作改为 streamGenerateContent?alt=sse。

curl "https://api.openfde.work/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "请介绍一下 RAG。"}]
      }
    ]
  }'

OpenAI-compatible 入口

如果客户端只支持 OpenAI SDK，可使用：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.openfde.work/v1",
)

response = client.chat.completions.create(
    model="gemini-3.1-pro-preview",
    messages=[{"role": "user", "content": "请介绍一下 RAG。"}],
    max_completion_tokens=512,
)
print(response.choices[0].message.content)

参数命名

Gemini 原生扩展通过 extra_body.google 传入。平台要求使用 snake_case：

• thinking_config.thinking_budget
• thinking_config.include_thoughts
• image_config.aspect_ratio
• image_config.image_size

thinkingConfig、thinkingBudget、includeThoughts、imageConfig、aspectRatio 和 imageSize 等 camelCase 写法会被拒绝，请不要继续使用。

是否支持搜索、代码执行、图像输入、视频输入和缓存由目标 Gemini 渠道决定。