Muxla 文档

外观

Gemini 接入指南 ​

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

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

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

按次计费 ​

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

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

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

价格预估 ​

Google 官方价格页给出了 Gemini 图像模型的图片输出预估。以下价格用于帮助你在按次计费前评估成本。

gemini-3.1-flash-lite-image 标准层级的图片输出价格为 30 美元 / 100 万 token。1K（1024x1024px）输出图片会消耗 1,120 个 token，相当于 $0.0336 / 张。

输出档位图片输出 token官方预估价格
1K1,120$0.0336 / 张

gemini-3.1-flash-image 标准层级的输入价格为 3 美元 / 100 万 token（文本和思考），图片输出价格为 60 美元 / 100 万 token。

输出档位官方预估价格
0.5K$0.045 / 张
1K$0.067 / 张
2K$0.101 / 张
4K$0.151 / 张

gemini-3-pro-image 的图片输出价格为 120 美元 / 100 万 token。

输出分辨率图片输出 token官方预估价格
1K 到 2K，分辨率介于 1024x1024px 到 2048x2048px1,120$0.134 / 张
最高 4K，分辨率最高 4096x4096px2,000$0.24 / 张

以上价格是 Google 官方按图片输出 token 给出的估算。实际可用模型、汇率、分组倍率和最终扣费请以 Muxla 控制台与官方价格页为准。

请求头 ​

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。

官方参考 ​