Gemini 原生接口

生成内容

curl "$BASE_URL/v1beta/models/GEMINI_MODEL:generateContent" -H "x-goog-api-key: $API_KEY" -H "Content-Type: application/json" -d '{"contents":[{"role":"user","parts":[{"text":"用三点解释什么是 API Key"}]}]}'

也可以使用 Bearer：

curl "$BASE_URL/v1beta/models/GEMINI_MODEL:generateContent" -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" -d '{"contents":[{"parts":[{"text":"你好"}]}]}'

流式生成

POST /v1beta/models/{model}:streamGenerateContent?alt=sse

客户端需要按 Gemini chunk 格式读取响应。不要把 Gemini 原生请求体直接发送到 Chat Completions 路径。

多模态和模型列表

parts 可以包含文本和 inline data。大文件建议使用上游支持的文件接口，再在请求中引用文件 URI。

curl "$BASE_URL/v1beta/models" -H "x-goog-api-key: $API_KEY"

如果客户端只支持 OpenAI 格式，改用 /v1/models 或配置 OpenAI-compatible Provider。