Gemini 接入指南

Gemini 生图使用原生风格接口：

txt

https://mux.la/v1beta/models/gemini-3.1-flash-image-preview:generateContent

上面的 gemini-3.1-flash-image-preview 是示例模型。实际调用时，请从 Muxla 控制台的模型列表中复制可用模型名称。

按次计费

Gemini 按次计费需要同时满足两个条件：

创建 Token / API Key 时选择支持按次计费的特定分组。一般这类分组名会带有 Count 字样。
请求体必须填写 generationConfig.imageConfig.imageSize，并且档位必须大写，例如 "1K"、"2K"、"4K"。

如果 Gemini 请求未填写 generationConfig.imageConfig.imageSize，则按量（token）计费。

请求头

http

Content-Type: application/json
Authorization: Bearer {API_KEY}

{API_KEY} 填写你的 Muxla Token。

文生图请求

bash

curl "https://mux.la/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer 你的 Muxla Token" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "生成一张 16:9 的科技产品发布会主视觉，干净、明亮、有空间感" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

文生图字段说明

contents：对话内容数组，Gemini 原生风格接口通过它接收用户输入。
role：消息角色。用户输入使用 "user"。
parts：一条消息里的内容片段数组，可以放文本，也可以放参考图。
text：文字提示词，描述你希望生成或编辑的图片。
generationConfig：生成配置。
responseModalities：期望返回的内容类型。生图请求使用 ["TEXT", "IMAGE"]，用于要求模型返回图片，部分中转或模型需要显式声明。
imageConfig：图片生成配置。
aspectRatio：图片宽高比，例如 "16:9"、"1:1"、"4:3"、"9:16"。
imageSize：分辨率档位，例如 "1K"、"2K"、"4K"。Gemini 如需按次计费，必须填写该字段，并且必须使用大写字母 K。

图生图请求

图生图请求可以在 parts 中同时传入文字和参考图：

json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "参考这张产品图，生成一张更适合电商详情页的白底展示图"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

图生图字段说明

inlineData：内联图片数据，用于把参考图直接放进请求体。
mimeType：参考图格式，例如 "image/png" 或 "image/jpeg"。
data：参考图的 base64 内容，不包含 data:image/png;base64, 前缀。

aspectRatio 用于控制宽高比，例如 "16:9"、"1:1"、"4:3"、"9:16"。imageSize 用于控制分辨率档位，例如 "1K"、"2K"、"4K"。档位必须大写，不能写成 "1k"、"2k" 或 "4k"。Gemini 不接受任意像素值，尺寸由宽高比和分辨率档位共同决定。

如果你希望 Gemini 按次计费，请务必填写 generationConfig.imageConfig.imageSize。

官方参考

Gemini 图像生成官方文档

Gemini 接入指南 ​

按次计费 ​

请求头 ​

文生图请求 ​

文生图字段说明 ​

图生图请求 ​

图生图字段说明 ​

官方参考 ​