Gemini原生格式

POST

/v1beta/models/{model_name}:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn

{model_name} 替换为具体的模型名称，例如：
/v1beta/models/gemini-3.1-flash-image-preview:generateContent

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

Body 参数application/json

示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "BASE64_REFERENCE_IMAGE_DATA"
          }
        },
        {
          "text": "Based on the reference image style and composition, create a 3D rendered image of a pig with wings and a top hat flying over a happy futuristic sci-fi city with lots of greenery. Keep the visual style consistent with the reference."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xgapi.top/v1beta/models/:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "BASE64_REFERENCE_IMAGE_DATA"
          }
        },
        {
          "text": "Based on the reference image style and composition, create a 3D rendered image of a pig with wings and a top hat flying over a happy futuristic sci-fi city with lots of greenery. Keep the visual style consistent with the reference."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-06-09 11:48:12

Generations

文生图text-to-image