> ## 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. # MiniMax H3 Image Generación de imágenes > - MiniMax H3 Image (minimax-h3-image) admite la generación de imágenes a partir de texto y la edición de imágenes, con hasta 16 imágenes de referencia - Salida de hasta 20 millones de píxeles: combine una relación de aspecto con un nivel de resolución 1K / 2K / 4K, o especifique el ancho y el alto en píxeles - Procesamiento asíncrono: use el ID de tarea devuelto para [consultar la tarea](/es/api-manual/task-management/get-task-detail) - Los enlaces de las imágenes generadas son válidos durante 24 horas. Guarde los resultados cuanto antes ## OpenAPI ````yaml es/api-manual/image-series/minimax-h3-image/minimax-h3-image-image-generation.json POST /v1/images/generations openapi: 3.1.0 info: title: API de minimax-h3-image 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: API de minimax-h3-image description: >- - MiniMax H3 Image (minimax-h3-image) admite la generación de imágenes a partir de texto y la edición de imágenes, con hasta 16 imágenes de referencia - Salida de hasta 20 millones de píxeles: combine una relación de aspecto con un nivel de resolución 1K / 2K / 4K, o especifique el ancho y el alto en píxeles - Procesamiento asíncrono: use el ID de tarea devuelto para [consultar la tarea](/es/api-manual/task-management/get-task-detail) - Los enlaces de las imágenes generadas son válidos durante 24 horas. Guarde los resultados cuanto antes operationId: createImageGenerationMinimaxH3Image requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: text_to_image: summary: Texto a imagen (simple) value: model: minimax-h3-image prompt: Una hermosa puesta de sol colorida sobre el océano text_to_image_hd: summary: Texto a imagen (HD 16:9) value: model: minimax-h3-image prompt: >- Plano amplio cinematográfico de un horizonte urbano futurista al atardecer size: '16:9' resolution: 4K 'n': 1 text_to_image_pixel: summary: Texto a imagen (píxeles explícitos) value: model: minimax-h3-image prompt: Diseño de logo minimalista size: 1024x1024 image_edit: summary: Imagen a imagen / Edición value: model: minimax-h3-image prompt: Añade un gatito lindo junto a ella size: '1:1' resolution: 1K image_urls: - https://example.com/input.png callback_url: https://your-domain.com/webhook/image-done batch_generation: summary: Generación por lotes value: model: minimax-h3-image prompt: Un lindo robot estilo pixel art size: '1:1' resolution: 2K '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: minimax-h3-image' 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. El canal oficial ofrece mayor estabilidad y control para uso comercial enum: - minimax-h3-image default: minimax-h3-image example: minimax-h3-image prompt: type: string description: >- Prompt que describe la imagen que se desea generar o cómo editar las imágenes de entrada **Límites de longitud:** - Hasta `32,000` caracteres (contados como puntos de código Unicode) - Si `prompt_extend` es `false`, solo se tienen en cuenta aproximadamente los primeros `4096` tokens del prompt example: Una hermosa puesta de sol colorida sobre el océano maxLength: 32000 image_urls: type: array description: >- Lista de URL de imágenes de referencia para la generación de imagen a imagen y la edición de imágenes **Notas:** - Número de imágenes de entrada por solicitud: `1~16` - Tamaño máximo por imagen: `64MB` - Ancho y alto de cada imagen: de `128` a `8192` px - Relación de aspecto de cada imagen: lado más largo / lado más corto no superior a `4:1` - Formatos admitidos: `.jpeg`, `.jpg`, `.png`, `.webp`, `.heic`, `.heif` - El servidor debe poder acceder directamente a las URL o estas deben iniciar una descarga directa (normalmente terminan en una extensión de imagen como `.png` o `.jpg`) - Las imágenes de referencia consumen tokens adicionales de imagen de entrada en la generación de imagen a imagen y la edición items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png size: type: string description: >- Tamaño de la imagen generada. Admite **relaciones de aspecto** y **dimensiones explícitas en píxeles**. Predeterminado: `auto` **① Relación de aspecto (recomendada):** `X:Y`. Relaciones habituales: - `1:1`: cuadrada - `1:2` / `2:1`: muy vertical / muy horizontal - `1:3` / `3:1`: extravertical / extrahorizontal (en el límite de 3:1) - `2:3` / `3:2`: retrato / paisaje estándar - `3:4` / `4:3`: retrato / paisaje tradicional - `4:5` / `5:4`: formatos habituales en redes sociales - `9:16` / `16:9`: pantalla ancha de móvil / escritorio - `9:21` / `21:9`: formatos ultraanchos También se admiten otros valores `X:Y`: `X` e `Y` deben ser enteros de `1` a `300`, con una relación de aspecto `≤ 3:1` **② Dimensiones explícitas en píxeles:** `WxH` (o `W×H`), por ejemplo `1024x1024`, `2720x1536`, `5472x3072` - Presupuesto de píxeles: `655,360 ≤ width × height ≤ 20,000,000` (aproximadamente de 0,65 MP a 20 MP) - Relación de aspecto: `≤ 3:1` **③ `auto`:** el modelo elige automáticamente la relación de aspecto; el área de salida sigue el nivel `resolution` **Tamaños fuera de los límites:** - Los tamaños fuera de estos límites devuelven `400`; no se redimensionan ni redondean automáticamente default: auto example: auto resolution: type: string description: >- Parámetro simplificado del nivel de resolución. Se aplica cuando `size` es `auto` o una relación de aspecto; se ignora con dimensiones explícitas en píxeles **Presupuesto de píxeles** (el ancho y el alto se calculan a partir del total de píxeles objetivo y la relación `size`): - `1K`: ~1 MP (1024² = 1,048,576 píxeles) - `2K`: ~4 MP (2048² = 4,194,304 píxeles) - `4K`: ~16,8 MP (4096² = 16,777,216 píxeles) **Dimensiones reales en paisaje / cuadrado** (en retrato se intercambian el ancho y el alto; por ejemplo, `3:4` invierte `4:3`): | Relación de aspecto | 2K | 4K | |---|---|---| | `1:1` | 2048×2048 | 4096×4096 | | `4:3` | 2368×1760 | 4736×3552 | | `16:9` | 2720×1536 | 5472×3072 | | `3:1` | 3552×1184 | 7104×2368 | **Notas:** - `1K` y `2K` usan el mismo número de tokens de imagen de salida (aproximadamente `4,096` por imagen); `4K` usa aproximadamente `16,384` por imagen. Prevalece el valor `usage` devuelto - Los valores no distinguen entre mayúsculas y minúsculas enum: - 1K - 2K - 4K default: 2K example: 2K output_format: type: string description: |- Formato del archivo de imagen de salida. Predeterminado: `jpeg` - `jpeg`: compresión con pérdida, archivos más pequeños - `png`: sin pérdida - `webp`: equilibrio entre tamaño y calidad **Nota:** - No se admiten fondos transparentes enum: - jpeg - png - webp default: jpeg example: jpeg 'n': type: integer description: >- Número de imágenes que se generarán. Cada imagen se factura por separado **Notas:** - Los tokens de texto y de imagen de entrada aumentan proporcionalmente con `n` - Si algunas imágenes fallan (por ejemplo, por controles de seguridad de contenido), la tarea se completa con las imágenes correctas. La cantidad real se indica en `results` en la respuesta, y la facturación sigue el valor `usage` devuelto minimum: 1 maximum: 10 default: 1 example: 1 prompt_extend: type: boolean description: >- Optimización del prompt: el modelo reescribe el prompt con más detalle antes de generar. Predeterminado: `true` **Notas:** - Solo se puede establecer en `false` para la generación a partir de texto cuando `size` es una relación de aspecto o dimensiones explícitas en píxeles - Si `size` es `auto` o se proporciona `image_urls`, establecerlo en `false` devuelve `400` - Si está activado, añade aproximadamente de `2,300` a `3,800` tokens de texto de entrada por imagen; si está desactivado, solo se contabiliza el prompt original default: true example: true 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: minimax-h3-image 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 ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.