> ## 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. # Grok Imagine Image 2.0 Generacion de imagenes > - Grok Imagine Image 2.0 (grok-imagine-image-2.0) es el modelo de generación y edición de imágenes de xAI: la generación de texto a imagen y la edición de imagen comparten el mismo nombre de modelo - Sin `image_urls` es texto a imagen; al enviar `1~3` imágenes de referencia cambia automáticamente al modo de edición de imagen, sin cambiar de modelo - 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/grok/grok-imagine-image-2.0-image-generate.json POST /v1/images/generations openapi: 3.1.0 info: title: grok-imagine-image-2.0 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: grok-imagine-image-2.0 API description: >- - Grok Imagine Image 2.0 (grok-imagine-image-2.0) es el modelo de generación y edición de imágenes de xAI: la generación de texto a imagen y la edición de imagen comparten el mismo nombre de modelo - Sin `image_urls` es texto a imagen; al enviar `1~3` imágenes de referencia cambia automáticamente al modo de edición de imagen, sin cambiar de modelo - 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: createImageGenerationGrokImagineImage2 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: text_to_image: summary: Texto a imagen (simple) value: model: grok-imagine-image-2.0 prompt: >- Calle de Tokio de noche en estilo cyberpunk, luces de neón reflejadas en el asfalto mojado text_to_image_hd: summary: Texto a imagen (2K panorámico) value: model: grok-imagine-image-2.0 prompt: >- Plano general cinematográfico del horizonte de una ciudad futurista al anochecer size: '16:9' resolution: 2K quality: medium image_edit: summary: Edición de imagen (una imagen de referencia) value: model: grok-imagine-image-2.0 prompt: Cambia la estación de la escena a un invierno nevado size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png callback_url: https://your-domain.com/webhook/image-done multi_image_edit: summary: Edición multiimagen (sintaxis de referencia) value: model: grok-imagine-image-2.0 prompt: >- Coloca al personaje de en la escena de manteniendo la misma iluminación size: '16:9' resolution: 1K quality: medium image_urls: - https://example.com/person.png - https://example.com/scene.png batch_generation: summary: Generación por lotes (nivel rápido) value: model: grok-imagine-image-2.0 prompt: Un robot adorable en estilo pixel art size: '1:1' resolution: 1K quality: low '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: grok-imagine-image-2.0' 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. La generación de texto a imagen y la edición de imagen comparten este nombre de modelo; el modo cambia automáticamente según se envíe o no `image_urls` enum: - grok-imagine-image-2.0 example: grok-imagine-image-2.0 prompt: type: string description: >- Prompt que describe la imagen que se desea generar o cómo editar las imágenes de referencia enviadas **Sintaxis de referencia multiimagen:** - Al enviar varias imágenes de referencia, use ``, ``, `` en el prompt para referirse a la 1.ª, 2.ª y 3.ª imagen de referencia respectivamente - Los índices comienzan en `0` y se corresponden uno a uno con el orden del array `image_urls` - Ejemplo: `Coloca al personaje de en la escena de ` example: >- Calle de Tokio de noche en estilo cyberpunk, luces de neón reflejadas en el asfalto mojado 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: `0~3` (sin este parámetro = texto a imagen, `1~3` = edición de imagen) - Solo se admiten URLs de imagen `http` / `https` accesibles públicamente; base64 y data URL no son compatibles - 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 la edición de imagen, las imágenes de referencia generan un coste adicional que se cuenta una sola vez por solicitud y no se multiplica por `n` items: type: string format: uri maxItems: 3 example: - https://example.com/person.png - https://example.com/scene.png size: type: string description: >- Relación de aspecto de la imagen generada; valor predeterminado `auto` **Relaciones admitidas (13):** | Relación | Descripción | |---|---| | `1:1` | Cuadrado | | `4:3` / `3:4` | Horizontal / vertical clásico | | `3:2` / `2:3` | Horizontal / vertical estándar | | `16:9` / `9:16` | Pantalla ancha / vertical móvil | | `2:1` / `1:2` | Muy ancho / muy alto | | `19.5:9` / `9:19.5` | Móvil pantalla completa horizontal / vertical | | `20:9` / `9:20` | Ultraancho horizontal / vertical | **Nota:** - `auto`: el modelo decide la relación por sí mismo; omitir este parámetro equivale a `auto` (la salida suele ser vertical) - Los valores fuera de la tabla anterior no son compatibles enum: - '1:1' - '4:3' - '3:4' - '3:2' - '2:3' - '16:9' - '9:16' - '2:1' - '1:2' - 19.5:9 - '9:19.5' - '20:9' - '9:20' - auto default: auto example: '16:9' resolution: type: string description: >- Nivel de píxeles de la imagen de salida; valor predeterminado `1K`; admite los niveles `1K` y `2K` **Nota:** - Este modelo no admite `4K` - Los valores no distinguen mayúsculas de minúsculas enum: - 1K - 2K default: 1K example: 1K quality: type: string description: >- Nivel de calidad de generación, controla la profundidad de razonamiento del modelo; valor predeterminado `medium` | Valor | Descripción | |---|---| | `low` | Generación más rápida y de menor coste | | `medium` | Mejor calidad y más detalle | **Nota:** - Este modelo solo admite los niveles `low` / `medium`; otros valores como `high` no son compatibles - `quality` (nivel de calidad) y `resolution` (nivel de píxeles) son independientes y se pueden combinar libremente - Los valores no distinguen mayúsculas de minúsculas enum: - low - medium default: medium example: medium 'n': type: integer description: >- Número de imágenes a generar, rango `1~10`, valor predeterminado `1` **Nota:** - Cada imagen se factura de forma independiente y el coste aumenta linealmente con `n` - El coste adicional de las imágenes de referencia se cuenta una sola vez por solicitud y no se multiplica por `n` - Al completarse la tarea, `result_urls` devuelve `n` enlaces de imagen independientes 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: grok-imagine-image-2.0 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: 3.06 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 ``` ````