Gemini 生图 API

https://linyiapi.ai

x-goog-api-key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "status": "UNAUTHENTICATED"
  }
}

curl 'https://linyiapi.ai/v1beta/models' \
  -H 'x-goog-api-key: YOUR_API_KEY'

curl 'https://linyiapi.ai/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl 'https://linyiapi.ai/v1beta/models/gemini-3.1-flash-lite-image-preview' \
  -H 'x-goog-api-key: YOUR_API_KEY'

{
  "name": "models/gemini-3.1-flash-lite-image-preview",
  "baseModelId": "gemini-3.1-flash-lite-image-preview",
  "displayName": "Gemini 3.1 Flash Lite Image",
  "supportedGenerationMethods": ["generateContent", "streamGenerateContent"],
  "imageConfig": {
    "aspectRatios": ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"],
    "imageSizes": ["1K"]
  },
  "aliasOf": "gemini-3.1-flash-lite-image"
}

curl --request POST \
  'https://linyiapi.ai/v1beta/models/gemini-3.1-flash-image:generateContent' \
  --header 'x-goog-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "一只戴着宇航员头盔的橘猫，电影感灯光，精致细节"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }'

candidates[].content.parts[].inlineData.data

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "电影感雨夜城市街景，霓虹灯倒映在湿润路面，广角构图"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

{
  "imageSize": "2K"
}

1:1
2:3
3:2
3:4
4:3
4:5
5:4
9:16
16:9
21:9

1:4
1:8
4:1
8:1

{
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "9:16",
      "imageSize": "4K"
    }
  }
}

POST /v1beta/models/{model}:generateContent

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "保留人物、构图和光线，把背景修改成雨夜霓虹街道"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "INPUT_IMAGE_BASE64"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

curl --request POST \
  'https://linyiapi.ai/v1beta/models/gemini-3.1-flash-image:generateContent' \
  --header 'x-goog-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "把背景改成星空，保留主体与构图，不要添加文字"
          },
          {
            "fileData": {
              "mimeType": "image/png",
              "fileUri": "https://your-cdn.example.com/path/to/input.png"
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "responseDelivery": "uri",
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }'

candidates[].content.parts[].fileData.fileUri

{
  "fileData": {
    "mimeType": "image/webp",
    "fileUri": "https://IMAGE_HOST/path/to/generated-image.webp"
  }
}

image_url rejected: ...
Failed to fetch image_url: 403
image too large, max 50MB

IMAGE_BASE64=$(base64 < input.jpg | tr -d '\n')

curl --request POST \
  'https://linyiapi.ai/v1beta/models/gemini-3.1-flash-image:generateContent' \
  --header 'x-goog-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw "{
    \"contents\": [{
      \"role\": \"user\",
      \"parts\": [
        {
          \"text\": \"保留杯子、构图、光线和背景不变，只把杯子从蓝色改成紫色，并在杯身增加三个白色星形图案，不要添加文字\"
        },
        {
          \"inlineData\": {
            \"mimeType\": \"image/jpeg\",
            \"data\": \"${IMAGE_BASE64}\"
          }
        }
      ]
    }],
    \"generationConfig\": {
      \"responseModalities\": [\"TEXT\", \"IMAGE\"],
      \"imageConfig\": {
        \"aspectRatio\": \"3:2\",
        \"imageSize\": \"1K\"
      }
    }
  }"

import base64
import requests

api_key = "YOUR_API_KEY"
model = "gemini-3.1-flash-image"
input_path = "input.jpg"

with open(input_path, "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

payload = {
    "contents": [{
        "role": "user",
        "parts": [
            {
                "text": "保留主体和构图，把背景改成雨夜霓虹街道"
            },
            {
                "inlineData": {
                    "mimeType": "image/jpeg",
                    "data": image_base64,
                }
            },
        ],
    }],
    "generationConfig": {
        "responseModalities": ["TEXT", "IMAGE"],
        "imageConfig": {
            "aspectRatio": "3:2",
            "imageSize": "1K",
        },
    },
}

response = requests.post(
    f"https://linyiapi.ai/v1beta/models/{model}:generateContent",
    headers={
        "x-goog-api-key": api_key,
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=300,
)
response.raise_for_status()
result = response.json()

saved = False
for candidate in result.get("candidates", []):
    for part in candidate.get("content", {}).get("parts", []):
        inline_data = part.get("inlineData", {})
        if inline_data.get("data"):
            mime_type = inline_data.get("mimeType", "image/png")
            extension = "jpg" if "jpeg" in mime_type else "webp" if "webp" in mime_type else "png"
            with open(f"gemini-edited.{extension}", "wb") as f:
                f.write(base64.b64decode(inline_data["data"]))
            saved = True
            break
    if saved:
        break

if not saved:
    raise RuntimeError("HTTP 请求成功，但响应中没有编辑后的图片")

保留：主体身份、姿势、镜头角度、构图和光线。
修改：把背景改成雨夜霓虹街道。
禁止：不要增加文字，不要改变人物脸部。

curl --request POST \
  'https://linyiapi.ai/v1beta/models/gemini-3.1-flash-image:generateContent' \
  --header 'x-goog-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "极简绿色方块，白色背景，无文字"}]
      }
    ],
    "generationConfig": {
      "responseDelivery": "uri",
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }'

{
  "fileData": {
    "mimeType": "image/webp",
    "fileUri": "https://IMAGE_HOST/path/to/generated-image.webp"
  }
}

candidates[].content.parts[].fileData.fileUri

{
  "generationConfig": {
    "responseDelivery": "inline",
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

candidates[].content.parts[].inlineData.data

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "已根据要求生成图片。"
          },
          {
            "inlineData": {
              "mimeType": "image/webp",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 0,
    "totalTokenCount": 15,
    "creditsConsumed": 20
  },
  "modelVersion": "gemini-3.1-flash-image",
  "createTime": 1780000000,
  "responseId": "RESPONSE_ID"
}

import { writeFile } from 'node:fs/promises';

const BASE_URL = process.env.GEMINI_BASE_URL || 'https://linyiapi.ai';
const API_KEY = process.env.GEMINI_API_KEY;
const MODEL = 'gemini-3.1-flash-image';

if (!API_KEY) throw new Error('缺少 GEMINI_API_KEY');

const payload = {
  contents: [
    {
      role: 'user',
      parts: [
        { text: '日落时分的海边灯塔，水彩插画，温暖色调，细腻纸张纹理' },
      ],
    },
  ],
  generationConfig: {
    responseDelivery: 'uri',
    responseModalities: ['TEXT', 'IMAGE'],
    imageConfig: {
      aspectRatio: '16:9',
      imageSize: '2K',
    },
  },
};

const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 300_000);

try {
  const response = await fetch(
    `${BASE_URL}/v1beta/models/${encodeURIComponent(MODEL)}:generateContent`,
    {
      method: 'POST',
      headers: {
        'x-goog-api-key': API_KEY,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(payload),
      signal: controller.signal,
    },
  );

  const text = await response.text();
  let data;
  try {
    data = JSON.parse(text);
  } catch {
    throw new Error(`服务返回非 JSON 内容：HTTP ${response.status}`);
  }

  if (!response.ok) {
    throw new Error(
      `HTTP ${response.status}: ${data?.error?.message || JSON.stringify(data)}`,
    );
  }

  const parts = data.candidates?.flatMap((candidate) => candidate.content?.parts || []) || [];
  const imagePart = parts.find((part) => part.inlineData?.data || part.fileData?.fileUri);

  if (!imagePart) {
    const reasons = data.candidates?.map((candidate) => candidate.finishReason).filter(Boolean);
    throw new Error(`请求完成但没有图片，finishReason=${reasons?.join(',') || 'unknown'}`);
  }

  if (imagePart.fileData?.fileUri) {
    console.log('图片 URL：', imagePart.fileData.fileUri);
  } else {
    const mimeType = imagePart.inlineData.mimeType || 'application/octet-stream';
    const extension = mimeType === 'image/jpeg'
      ? 'jpg'
      : mimeType === 'image/webp'
        ? 'webp'
        : 'png';

    await writeFile(
      `gemini-output.${extension}`,
      Buffer.from(imagePart.inlineData.data, 'base64'),
    );
    console.log(`图片已保存为 gemini-output.${extension}`);
  }

  console.log('responseId：', data.responseId || null);
  console.log('usageMetadata：', data.usageMetadata || null);
} finally {
  clearTimeout(timer);
}

import base64
import os
from pathlib import Path
import requests

BASE_URL = os.getenv("GEMINI_BASE_URL", "https://linyiapi.ai")
API_KEY = os.environ["GEMINI_API_KEY"]
MODEL = "gemini-3.1-flash-image"

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [
                {"text": "未来主义建筑群，清晨薄雾，超广角摄影，真实材质"}
            ],
        }
    ],
    "generationConfig": {
        "responseDelivery": "uri",
        "responseModalities": ["TEXT", "IMAGE"],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K",
        },
    },
}

response = requests.post(
    f"{BASE_URL}/v1beta/models/{MODEL}:generateContent",
    headers={
        "x-goog-api-key": API_KEY,
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=300,
)

data = response.json()
if not response.ok:
    message = data.get("error", {}).get("message", data)
    raise RuntimeError(f"HTTP {response.status_code}: {message}")

image_part = None
for candidate in data.get("candidates", []):
    for part in candidate.get("content", {}).get("parts", []):
        if part.get("inlineData", {}).get("data") or part.get("fileData", {}).get("fileUri"):
            image_part = part
            break
    if image_part:
        break

if not image_part:
    reasons = [candidate.get("finishReason") for candidate in data.get("candidates", [])]
    raise RuntimeError(f"请求完成但没有返回图片，finishReason={reasons}")

file_uri = image_part.get("fileData", {}).get("fileUri")
if file_uri:
    print("图片 URL:", file_uri)
else:
    inline_data = image_part["inlineData"]
    mime_type = inline_data.get("mimeType", "application/octet-stream")
    extension = {
        "image/jpeg": "jpg",
        "image/webp": "webp",
    }.get(mime_type, "png")
    Path(f"gemini-output.{extension}").write_bytes(
        base64.b64decode(inline_data["data"])
    )
    print(f"图片已保存为 gemini-output.{extension}")

print("responseId:", data.get("responseId"))
print("usageMetadata:", data.get("usageMetadata"))

{
  "error": {
    "code": 429,
    "message": "service rate limit exceeded",
    "status": "RESOURCE_EXHAUSTED"
  }
}

客户端超时 ≥ 最大排队时间 + 对应分辨率的 p95 生成耗时 + 网络余量

第 1 次：1～2 秒随机抖动
第 2 次：3～5 秒随机抖动
第 3 次：8～12 秒随机抖动