> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2 Generación de imágenes > - El modelo GPT Image 2 (gpt-image-2) soporta modos de generación de texto a imagen, imagen a imagen, edición de imagen y otros - Modo de procesamiento asíncrono, usa el ID de tarea devuelto para [consultar](/es/api-manual/task-management/get-task-detail) - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente ## OpenAPI ````yaml es/api-manual/image-series/gpt-image-2/gpt-image-2-image-generation.json POST /v1/images/generations openapi: 3.1.0 info: title: gpt-image-2 API description: >- Crear tareas de imagen usando modelos de IA con soporte para múltiples modelos y configuraciones de parámetros license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Producción security: - bearerAuth: [] tags: - name: Generación de imágenes description: APIs relacionadas con generación de imágenes por IA paths: /v1/images/generations: post: tags: - Generación de imágenes summary: gpt-image-2 API description: >- - El modelo GPT Image 2 (gpt-image-2) soporta modos de generación de texto a imagen, imagen a imagen, edición de imagen y otros - Modo de procesamiento asíncrono, usa el ID de tarea devuelto para [consultar](/es/api-manual/task-management/get-task-detail) - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente operationId: createImageGenerationGptImage2 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: text_to_image: summary: Texto a imagen (simple) value: model: gpt-image-2 prompt: Una hermosa puesta de sol colorida sobre el océano text_to_image_hd: summary: Texto a imagen (HD 16:9) value: model: gpt-image-2 prompt: >- Plano amplio cinematográfico de un horizonte urbano futurista al atardecer size: '16:9' resolution: 4K quality: high 'n': 1 text_to_image_pixel: summary: Texto a imagen (píxeles explícitos) value: model: gpt-image-2 prompt: Diseño de logo minimalista size: 1024x1024 quality: medium image_edit: summary: Imagen a imagen / Edición value: model: gpt-image-2 prompt: Añade un gatito lindo junto a ella size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png callback_url: https://your-domain.com/webhook/image-done image_inpaint: summary: Inpainting (con máscara) value: model: gpt-image-2 prompt: Reemplaza el cielo con un cielo estrellado size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png mask_url: https://example.com/mask.png batch_generation: summary: Generación por lotes value: model: gpt-image-2 prompt: Un lindo robot estilo pixel art size: '1:1' resolution: 2K quality: high 'n': 4 responses: '200': description: Tarea de imagen creada con éxito content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: Parámetros de solicitud inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: No autenticado, token inválido o expirado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Cuota insuficiente, se requiere recarga content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Acceso denegado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: gpt-image-2' type: invalid_request_error '429': description: Límite de frecuencia excedido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: ImageGenerationRequest: type: object required: - model - prompt properties: model: type: string description: >- Nombre del modelo de generación de imágenes, canal oficial, mejor estabilidad y controlabilidad, adecuado para escenarios comerciales enum: - gpt-image-2 default: gpt-image-2 example: gpt-image-2 prompt: type: string description: >- Prompt que describe la imagen a generar, o que describe cómo editar la imagen de entrada **Límites:** - Hasta `32000` caracteres (contados por puntos de código Unicode, válido para CJK y otros idiomas) - Si el prompt supera los `8000` tokens, la imagen generada puede no coincidir con lo esperado; se recomienda reducir el prompt example: Una hermosa puesta de sol colorida sobre el océano maxLength: 32000 image_urls: type: array description: >- Lista de URLs de imagen de referencia para funciones de imagen a imagen y edición de imagen **Nota:** - Número de imágenes de entrada por solicitud: `1~16` - Tamaño de una sola imagen: no más de `50MB` - Píxeles de una sola imagen: ancho × alto no más de `178.956.970` px - Longitud de lado de una sola imagen: ancho / alto sin superar `23170` px cada uno; al superarlo pueden producirse errores - Formatos de archivo admitidos: `.jpeg`, `.jpg`, `.png`, `.webp` - Las URLs de imagen deben ser directamente accesibles por el servidor, o la URL de imagen debe activar la descarga directa al acceder (generalmente estas URLs terminan con extensiones de archivo de imagen, como `.png`, `.jpg`) - En escenarios de imagen a imagen / edición de imagen, las imágenes de referencia enviadas generan consumo adicional de tokens de imagen de entrada items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png mask_url: type: string format: uri description: >- URL de la máscara de inpainting — marca la región de la imagen de referencia que se va a regenerar. **Solo válida en modo de edición de imagen** (debe combinarse con `image_urls`); en texto-a-imagen puro, la máscara se ignora silenciosamente. **Requisitos de formato:** - **Debe ser un PNG con canal alfa**: píxeles transparentes (`alpha < 255`) = áreas a regenerar, píxeles opacos = preservados - **Las dimensiones de la máscara deben coincidir exactamente con las de la imagen de referencia** (ancho × alto en píxeles) - Una máscara por solicitud **Nota:** - Se requiere al menos una imagen de referencia en `image_urls`; una máscara sola no tiene efecto - Errores comunes: - `Invalid mask image format - mask image missing alpha channel`: la imagen subida no tiene canal alfa (JPEG, PNG opaco, etc.). Reexporta la máscara como PNG con regiones transparentes. - `Invalid mask image format - mask size does not match image size`: las dimensiones de la máscara no coinciden con la imagen de referencia. Redimensiona la máscara a las mismas dimensiones en píxeles que tu imagen de referencia. example: https://example.com/mask.png size: type: string description: >- Tamaño de la imagen generada. Admite **formato de proporción** y **formato de píxeles explícito**, por defecto `auto` **① Formato de proporción (recomendado, 15 opciones)** - `1:1`: Cuadrado - `1:2` / `2:1`: Vertical / horizontal extremo - `1:3` / `3:1`: Ultra vertical / horizontal (límite 3:1) - `2:3` / `3:2`: Vertical / horizontal estándar - `3:4` / `4:3`: Vertical / horizontal clásico - `4:5` / `5:4`: Comunes en redes sociales - `9:16` / `16:9`: Pantalla ancha móvil / escritorio - `9:21` / `21:9`: Ultra-ancha **② Formato de píxeles explícito**: `WxH` (o `W×H`), p. ej. `1024x1024`, `1536x1024`, `3840×2160` - Ancho y alto deben ser múltiplos de `16` - Rango de cada borde: `[16, 3840]` - Presupuesto de píxeles: `655.360 ≤ width × height ≤ 8.294.400` (aprox. 0,65 MP ~ 8,29 MP) - Relación de aspecto: `≤ 3:1` **③ `auto`**: El modelo decide el tamaño automáticamente (en este caso `resolution` no se aplica) **Manejo de desbordamiento:** - Si una combinación de proporción + `resolution` excede el presupuesto de píxeles, las dimensiones se reducen proporcionalmente al máximo permitido (p. ej. 4K 2:1 → 3840×1920) default: auto example: auto resolution: type: string description: >- Parámetro rápido de nivel de resolución, solo efectivo cuando `size` está en formato de proporción; en formato de píxeles explícito este campo se ignora **Reglas de presupuesto de píxeles** (las dimensiones se calculan a partir del recuento total de píxeles objetivo y la proporción de `size`, alineadas a múltiplos de 16): - `1K`: ~1 MP (1024² = 1.048.576 píxeles) - `2K`: ~4 MP (2048² = 4.194.304 píxeles) - `4K`: ~8,29 MP (3840×2160 = 8.294.400 píxeles, el máximo) **Tamaños de salida horizontal / cuadrado** (los tamaños verticales son el horizontal con ancho/alto intercambiados, p. ej. `2:3` = `3:2` invertido): | Proporción | 1K | 2K | 4K | |---|---|---|---| | `1:1` | 1024×1024 | 2048×2048 | 2880×2880 | | `2:1` | 1456×720 | 2896×1456 | 3840×1920 \* | | `3:1` | 1776×592 | 3552×1184 | 3840×1280 \* | | `3:2` | 1248×832 | 2512×1680 | 3520×2352 | | `4:3` | 1184×880 | 2368×1776 | 3312×2480 \* | | `5:4` | 1152×912 | 2288×1824 | 3216×2576 | | `16:9` | 1360×768 | 2736×1536 | 3840×2160 (UHD) | | `21:9` | 1568×672 | 3136×1344 | 3840×1632 \* | \* Indica combinaciones que se reducen automáticamente para caber en el presupuesto de píxeles. Los valores no distinguen mayúsculas/minúsculas. enum: - 1K - 2K - 4K default: 1K example: 1K quality: type: string description: >- Calidad de renderizado, controla la "profundidad de razonamiento" del modelo, afecta directamente el número de tokens de salida y el costo. Por defecto `medium` | Valor | Base de tile | Costo relativo (1024²) | |---|---|---| | `low` | 16 | ~0,11× | | `medium` | 48 | 1,0× | | `high` | 96 | ~4,0× | enum: - low - medium - high default: medium example: medium 'n': type: integer description: >- Cantidad de imágenes a generar, cada una facturada de forma independiente **Nota:** - Los tokens de entrada de texto escalan proporcionalmente con `n` minimum: 1 maximum: 10 default: 1 example: 1 callback_url: type: string description: >- Dirección de callback HTTPS después de completar la tarea **Momento del callback:** - Se activa cuando la tarea se completa, falla o se cancela - Se envía después de completar la confirmación de facturación **Restricciones de seguridad:** - Solo se admite el protocolo HTTPS - El callback a direcciones IP internas está prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longitud de la URL no debe exceder `2048` caracteres **Mecanismo de callback:** - Tiempo de espera: `10` segundos - Máximo `3` reintentos en caso de fallo (reintentos después de `1` segundo/`2` segundos/`4` segundos) - El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas - La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: Marca de tiempo de creación de la tarea example: 1757156493 id: type: string description: ID de tarea example: task-unified-1757156493-imcg5zqt model: type: string description: Nombre del modelo usado realmente example: gpt-image-2 object: type: string enum: - image.generation.task description: Tipo específico de tarea progress: type: integer description: Porcentaje de progreso de la tarea (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Estado de la tarea enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/TaskInfo' description: Información de tarea asíncrona type: type: string enum: - text - image - audio - video description: Tipo de salida de la tarea example: image usage: $ref: '#/components/schemas/Usage' description: Información de uso y facturación ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identificador de código de error message: type: string description: Descripción del error type: type: string description: Tipo de error TaskInfo: type: object properties: can_cancel: type: boolean description: Si la tarea puede ser cancelada example: true estimated_time: type: integer description: Tiempo estimado de finalización (segundos) minimum: 0 example: 100 Usage: type: object description: Información de uso y facturación properties: billing_rule: type: string description: Regla de facturación enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Créditos consumidos estimados minimum: 0 example: 2.5 user_group: type: string description: Categoría de grupo de usuarios example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Todas las APIs requieren autenticación Bearer Token## **Obtener API Key:** Visita la [Página de gestión de API Key](https://evolink.ai/dashboard/keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ``` ````