Google 图片生成

使用 kukuai.fyi 的 Google / Gemini 图片生成能力，支持文生图与图生图。

使用 kukuai.fyi 的 Google / Gemini 图片生成能力，支持文生图与图生图。

POSThttps://www.kukuai.fyi/api-proxy/china/v1beta/models/NanoBanana2:generateContent

请求需携带 `Authorization: Bearer ``<API_KEY>```。 如果还没有 Key，请先到 kukuai.fyi 控制台 创建。

文生图

文生图只需要在 contents[].parts[].text 写入提示词，并在generationConfig.imageConfig 里设置画幅比例和清晰度。 下面示例使用 NanoBanana2 走 Google/Gemini generateContent生成一张 1:1 图片。

export API_KEY="YOUR_KUKUAI_API_KEY"
export BASE_URL="https://www.kukuai.fyi/api-proxy/china"
export MODEL="NanoBanana2"

curl -s -X POST \
  "$BASE_URL/v1beta/models/$MODEL:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{
        "text": "月光下的竹林小径"
      }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }' > response.json

jq -r '.. | objects | (.inlineData?.data // .inline_data?.data)? | select(.)' response.json \
  | head -n 1 \
  | base64 -d > output.png

图生图

图生图在 contents[].parts 中同时传入文字指令和参考图。 参考图应是公网可访问 URL；如果你使用临时签名 URL，请确认有效期足够完成请求。

export API_KEY="YOUR_KUKUAI_API_KEY"
export BASE_URL="https://www.kukuai.fyi/api-proxy/china"
export MODEL="NanoBanana2"

curl -s -X POST \
  "$BASE_URL/v1beta/models/$MODEL:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {
          "text": "保留参考图主体，将背景改成月光下的竹林小径"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://example.com/reference.png"
          }
        }
      ]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }' > response.json

Gemini 原生 generateContent

NanoBanana2 与 gemini-3-pro-image-preview 都走 Gemini 原生兼容接口：/v1beta/models/{model}:generateContent。 如果你使用中国调用线路，可把官方 Gemini 域名替换成 https://www.kukuai.fyi/api-proxy/china。

export API_KEY="YOUR_KUKUAI_API_KEY"
export BASE_URL="https://www.kukuai.fyi/api-proxy/china"
export MODEL="gemini-3-pro-image-preview"

curl -s -X POST \
  "$BASE_URL/v1beta/models/$MODEL:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{
        "text": "生成一张16:9的赛博朋克城市夜景，霓虹灯，雨夜，电影感，高细节"
      }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }' > response.json

jq -r '.. | objects | (.inlineData?.data // .inline_data?.data)? | select(.)' response.json \
  | head -n 1 \
  | base64 -d > output.png

请求字段

字段	类型	必填	说明
contents	array<Content>	必填	Gemini generateContent 输入。文生图只需要文本 part；图生图同时传文本 part 和图片 part。
contents[].parts[].text	string	必填	生成或编辑图片的文字指令。建议明确主体、风格、比例、细节和限制。
contents[].parts[].fileData	object	可选	图生图参考图。包含 mimeType 和 fileUri，图片 URL 需要能被服务端访问。
generationConfig.responseModalities	string[]	必填	生成图片时需要包含 IMAGE，也可同时返回文本说明。默认值：["TEXT", "IMAGE"]。
generationConfig.imageConfig.aspectRatio	string	可选	图片比例，例如 1:1、16:9、9:16、4:3、3:4。默认值：1:1。
generationConfig.imageConfig.imageSize	string	可选	输出清晰度，使用大写，例如 1K、2K、4K。默认值：1K。

使用提醒

• 图生图失败时，优先检查 fileData.fileUri 是否可公网访问，以及 mimeType 是否和图片格式一致。
• 多张参考图可以继续往 contents[].parts 里追加多个 fileData part。
• Gemini 原生接口如果返回 401，可把 Authorization: Bearer 改成 x-goog-api-key 重试。
• NanoBanana2 与 gemini-3-pro-image-preview 的 aspectRatio 可用 1:1、16:9、9:16、4:3、3:4 等，imageSize 使用 1K、2K、4K。
• 更多可用图像模型可在 模型导航 的 Image 分类查看。