跳转到主要内容
POST
/
v1beta
/
models
/
{model}
:generateContent
Gemini 原生(图像)
curl --request POST \
  --url https://api.gravitex.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: <authorization>'

Documentation Index

Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt

Use this file to discover all available pages before exploring further.

简介

Gemini 图像可通过两种协议调用:
  • Gemini 原生POST /v1beta/models/{model}:generateContent,设置 responseModalities: ["IMAGE"]imageConfig
  • OpenAI 兼容POST /v1/images/generations(见 Nano Banana)或 POST /v1/chat/completions(部分图像模型)
若使用 OpenAI SDK 或统一 images/generations 入口,请优先阅读 Nano Banana 文档。

认证

Authorization
string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx
x-goog-api-key
string
可选:x-goog-api-key: sk-xxxxxxxxxx

支持的模型(示例)

模型 ID说明推荐端点
gemini-2.5-flash-imageNano Banana/v1/images/generations 或原生 generateContent
gemini-3-pro-image-previewNano Banana Pro同上

请求示例

curl -X POST "https://api.gravitex.ai/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "画一只在花园里玩耍的橙色小猫,高质量摄影"}]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K",
        "imageOutputOptions": {"mimeType": "image/png"}
      }
    }
  }'
图片在 candidates[0].content.parts[].inlineData(Base64)。

常用参数

  • generationConfig.responseModalities:须包含 "IMAGE"
  • generationConfig.imageConfig.aspectRatio:如 1:116:9
  • generationConfig.imageConfig.imageSize:如 1K2K3K
  • contents[].parts:文生图为 text;图生图可加入 inlineData(图片 Base64)
完整 Gemini 能力(思考模式、工具调用、流式等)见 原生 Gemini 格式