Generar imágenes con Gemini

POST

v1beta

models

{model}

:generateContent

import os
from google import genai
from google.genai import types

client = genai.Client(
    http_options={"api_version": "v1beta", "base_url": "https://api.cometapi.com"},
    api_key=os.environ.get("COMETAPI_KEY"),
)

response = client.models.generate_content(
    model="gemini-3.1-flash-lite-image",
    contents="A Monarch butterfly anatomical sketch on textured parchment",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="1:1", image_size="1K"),
    ),
)

final_image = None
for part in response.parts:
    if getattr(part, "thought", False):
        continue
    if part.text:
        print(part.text)
    elif image := part.as_image():
        final_image = image

if final_image:
    final_image.save("output.png")

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ]
      },
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123
  }
}

Para ver ejemplos paso a paso, consulta Use Gemini image models.

Las opciones de generación de imágenes de Gemini pueden cambiar a medida que Google actualiza los modelos de imágenes y generateContent. Consulta la documentación de generación de imágenes de Gemini para ver la lista completa más reciente de parámetros y el comportamiento específico del proveedor.

El proveedor tiene programado el cierre de gemini-2.5-flash-image para el 2026-10-02. Para proyectos nuevos, usa gemini-3.1-flash-image-preview o gemini-3-pro-image-preview. Consulta el calendario de descontinuación de Google para obtener más detalles.

Las respuestas de imágenes de Gemini pueden incluir partes de imagen intermedias donde thought es true. Estas no son el resultado final. Al guardar imágenes generadas, omite las partes con thought: true y usa la última parte de imagen donde exista inlineData y thought no sea true.

Autorizaciones

Authorization

string

header

requerido

Use your CometAPI API key.

Parámetros de ruta

model

string

predeterminado:gemini-3.1-flash-image-preview

requerido

The Gemini image model to use. See the Models page for current options.

Cuerpo

application/json

contents

object[]

requerido

Conversation turns. Each item has a role ("user" or "model") and parts array containing text and/or image data.

Show child attributes

generationConfig

object

Controls generation behavior — output modalities, image resolution, thinking, etc.

Show child attributes

tools

object[]

Optional tools. Pass [{"google_search": {}}] to enable Google Search grounding for real-time information in generated images.

Show child attributes

Respuesta

200 - application/json

Success

candidates

object[]

Show child attributes

usageMetadata

object

Show child attributes

Crear edición de imagen

Usar modelos de imagen Gemini

import os
from google import genai
from google.genai import types

client = genai.Client(
    http_options={"api_version": "v1beta", "base_url": "https://api.cometapi.com"},
    api_key=os.environ.get("COMETAPI_KEY"),
)

response = client.models.generate_content(
    model="gemini-3.1-flash-lite-image",
    contents="A Monarch butterfly anatomical sketch on textured parchment",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="1:1", image_size="1K"),
    ),
)

final_image = None
for part in response.parts:
    if getattr(part, "thought", False):
        continue
    if part.text:
        print(part.text)
    elif image := part.as_image():
        final_image = image

if final_image:
    final_image.save("output.png")

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ]
      },
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123
  }
}

Moderación de contenido

Claves API

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta