logo
RunComfy
  • ComfyUI
  • EntrenadorNuevo
  • Modelos
  • API
  • Precios
discord logo
MODELOS
Explorar
Todos los modelos
BIBLIOTECA
Generaciones
APIS DE MODELOS
Documentación de la API
Claves API
CUENTA
Uso

Gemini 3 Pro Text-to-Image: Generación de imágenes configurable | RunComfy

google/gemini-3-pro-image-preview/text-to-image

Genera de 1 a 4 imágenes a partir de un prompt obligatorio, con 10 relaciones de aspecto, resolución 1K, 2K o 4K, tres formatos de archivo y retorno síncrono opcional.

Índice

1. Primeros pasos2. Autenticación3. Referencia de la APIEnviar una solicitudEstado de la solicitudObtener resultadosCancelar solicitud4. Archivos de entradaArchivo alojado (URL)5. EsquemaEsquema de entradaEsquema de salida

1. Primeros pasos

Usa la API de RunComfy para ejecutar google/gemini-3-pro-image-preview/text-to-image. Para entradas y salidas admitidas, consulta el esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
  }'

2. Autenticación

Define la variable de entorno YOUR_API_TOKEN con tu clave API (gestión en Perfil) e incluye en cada solicitud un token Bearer en la cabecera Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referencia de la API

Enviar una solicitud

Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
  }'

Estado de la solicitud

Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obtener resultados

Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitud

Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Archivos de entrada

Archivo alojado (URL)

Proporciona una URL HTTPS públicamente accesible. El host debe permitir peticiones del servidor (sin login/cookies), sin rate limit agresivo ni bloqueo de bots. Recomendado: imágenes ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min a 720p). Para activos privados, URLs estables o firmadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Descripción de texto de la imagen o imágenes a generar.",
      "type": "string",
      "default": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
    },
    "aspect_ratio": {
      "title": "Relación de aspecto (An:Al)",
      "description": "Relación de aspecto de las imágenes generadas. Elija uno de los 10 valores enumerados.",
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "3:2",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "2:3",
        "9:16"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "Resolución",
      "description": "Resolución de salida. Valores permitidos: `1K`, `2K` y `4K`.",
      "type": "string",
      "enum": [
        "1K",
        "2K",
        "4K"
      ],
      "default": "1K"
    },
    "output_format": {
      "title": "Formato de salida",
      "description": "Formato de imagen de salida. Valores permitidos: `jpeg`, `png` y `webp`; predeterminado: `png`.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "num_images": {
      "title": "Número de imágenes",
      "description": "Número de imágenes a generar. Rango permitido: 1 a 4; predeterminado: 1.",
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 4
    },
    "sync_mode": {
      "title": "Modo síncrono",
      "description": "Cuando `true`, el medio se devuelve como un URI de datos y sus datos de salida no se almacenan en el historial de solicitudes. El valor predeterminado es `false`.",
      "type": "boolean",
      "default": false
    }
  }
}

Esquema de salida

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de una sola imagen"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de un solo vídeo"
      },
      "images": {
        "type": "array",
        "description": "varias URLs de imagen",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "varias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Síguenos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Soporte
  • Discord
  • Correo electrónico
  • Estado del sistema
  • afiliado
Modelos de Video
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • Ver todos los modelos →
Modelos de Imagen
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Ver todos los modelos →
Legal
  • Términos de servicio
  • Política de privacidad
  • Política de cookies
RunComfy
Derechos de autor 2026 RunComfy. Todos los derechos reservados.

RunComfy es la principal ComfyUI plataforma, ofreciendo ComfyUI en línea entorno y servicios, junto con flujos de trabajo de ComfyUI con impresionantes imágenes. RunComfy también ofrece AI Models, permitiendo a los artistas aprovechar las últimas herramientas de AI para crear arte increíble.