MiniMax

MiniMax H3 Image

minimax-h3-image/image-to-image

Modelo de imagen MiniMax, la generación de imágenes a partir de texto y la edición con 1–16 imágenes de referencia comparten un mismo conjunto de capacidades, salida de hasta 4K, compatibilidad con diez formatos de imagen y proporción automática, ideal para diseño conceptual, visuales comerciales y creación en múltiples estilos

minimax-h3-image/image-to-image minimax-h3-image/text-to-image

Probar minimax-h3-image/image-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

minimax-h3-image/image-to-image per image

Especificaciones	Precio unitario
1K	$0.0129 + $0.0036 Per Reference Image
2K	$0.0129 + $0.0036 Per Reference Image
4K	$0.0393 + $0.0036 Per Reference Image

Descripción general

Orientado a desarrolladores con necesidades de edición y composición de imágenes, ofrece un servicio de generación de imagen a imagen basado en imágenes de referencia. Acepta de 1 a 16 imágenes en formato JPG, PNG o WEBP como referencia, que se citan en el prompt en el orden de las imágenes como Picture 1, Picture 2, etc., para describir la edición o fusión que debe realizarse. La salida es una imagen estática, compatible con tres niveles de resolución 1K, 2K y 4K, así como con múltiples relaciones de aspecto, y con opción de formato JPEG o PNG; resulta adecuado para diseño conceptual, retoque de material visual y composición de múltiples imágenes, entre otros usos.

Puntos clave

Compatible con fusión de múltiples imágenes de referencia: se pueden enviar hasta 16 imágenes de referencia en una sola solicitud, lo que permite editar o combinar varias imágenes; cada imagen de referencia se factura por unidad.
Resolución de salida seleccionable por niveles: ofrece tres niveles de resolución de salida 1K, 2K y 4K, equivalentes aproximadamente a 1MP, 4MP y 16MP respectivamente, seleccionables según el uso del material.
Semilla fija para reproducir resultados: mediante el parámetro seed se puede fijar la semilla aleatoria para reproducir resultados; si se omite, se utiliza una semilla aleatoria.
Relación de aspecto de selección automática: aspect_ratio tiene el valor predeterminado auto, y el modelo decide la relación de salida según el prompt y las imágenes de referencia; también se pueden especificar 10 relaciones fijas.

Descripción de capacidades

Edición y fusión con múltiples imágenes de referencia: se envían de 1 a 16 imágenes de referencia y un prompt de edición de hasta 5000 caracteres, citando Picture 1, Picture 2, etc. en el orden de las imágenes; se pueden editar imágenes existentes o combinar varias imágenes en una nueva escena, con salida de imagen estática.

Control de resolución de salida y relación de aspecto: resolution admite 1K, 2K y 4K, correspondientes a salidas de aproximadamente 1MP, 4MP y 16MP; aspect_ratio admite 11 relaciones de aspecto como 1:1, 16:9 y 21:9, con valor predeterminado auto, decidido automáticamente por el modelo según el prompt y las imágenes de referencia.

Control de formato de salida y semilla: output_format admite jpeg o png; PNG ocupa aproximadamente 12MB en 2K y unos 30MB en 4K; seed acepta enteros de 0 a 2147483647 y sirve para reproducir resultados; si se omite, es aleatorio.

Escenarios de aplicación

Retoque de diseño conceptual basado en imágenes de referencia: el diseñador sube imágenes de referencia de personajes o escenas y describe la dirección de modificación, y obtiene la imagen conceptual editada para la evolución de propuestas y la comunicación visual.
Composición de material visual comercial con múltiples imágenes: se introducen varias imágenes de producto o de fondo como referencia para generar material fusionado en alta resolución, destinado a publicidad y exhibición en comercio electrónico.
Edición de imágenes existentes según instrucciones: el equipo de operaciones o los creadores de contenido suben imágenes existentes y describen los ajustes necesarios, y obtienen la imagen estática modificada para redes sociales o ilustraciones de páginas.

Limitaciones y recomendaciones de selección

Cada solicitud debe incluir al menos 1 y como máximo 16 imágenes de referencia; el lado de cada imagen debe estar entre 128 y 8192 píxeles, el tamaño no debe superar los 20MB y el formato está limitado a JPG, PNG o WEBP. El prompt admite como máximo 5000 caracteres y debe contener contenido que no sea solo espacios en blanco. Las imágenes de referencia se facturan por unidad. La salida es una imagen estática y no admite la generación de contenido de vídeo o audio. Los archivos en formato PNG son notablemente más grandes que los JPEG, alrededor de 30MB en 4K, por lo que conviene tener en cuenta el coste de almacenamiento y transferencia.

Novedades

Ver el registro de cambios →

Nuevo modelo MiniMax H3 Image ya disponible: generación de imágenes a partir de texto y edición con múltiples referencias Nov 12, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Cuántas imágenes de referencia se pueden proporcionar como máximo?

La conversión de imagen a imagen acepta como máximo 16 imágenes de referencia por vez y como mínimo 1, en formato JPG, PNG o WEBP, con lados de 128–8192 px y un tamaño máximo de 20 MB por imagen. Cada imagen de referencia tiene un coste adicional de $0.0036; por ejemplo, una imagen 2K con 3 imágenes de referencia cuesta en total $0.0129 + 3 × $0.0036 = $0.0237. Al escribir el prompt, haz referencia a cada imagen con numeraciones como Picture 1, Picture 2, en el orden en que se envían, para que el modelo pueda corresponder correctamente los objetos que deseas editar o combinar.
¿Cómo se define el tamaño de salida y hasta cuánto puede llegar?

La resolución tiene tres niveles: 1K, 2K y 4K, que equivalen aproximadamente a 1 MP, 4 MP y 16 MP respectivamente; el valor predeterminado es 2K. La relación de aspecto puede ser auto o 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9; al elegir auto, el modelo lo decide combinando el prompt y la imagen de referencia, así que si necesitas una composición fija, especifícala explícitamente.
¿Cómo se debe escribir el prompt para conservar el aspecto del personaje?

Organiza el texto en este orden: primero describe el sujeto que quieres conservar, luego escribe la parte que quieres cambiar y, por último, usa números para referirte a las imágenes: ① empieza con una o dos frases que fijen los rasgos externos del sujeto, como el peinado, la ropa, la combinación de colores y los detalles distintivos; ② después indica la escena objetivo, la pose, el encuadre y la iluminación; ③ cuando necesites hacer referencia a una imagen de referencia, escribe «la persona de la Picture 1» y numera varias imágenes según el orden en que se pasan. El límite del prompt es de 5000 caracteres; incluir los detalles en el cuerpo del texto es más eficaz que acumular adjetivos.
¿Cómo puedo crear un conjunto de imágenes de vista múltiple del mismo personaje?

Empieza usando una imagen de referencia con el sujeto claro y sin oclusiones como Picture 1, fija la descripción de los rasgos del personaje en el prompt y, después, genera las imágenes una por una cambiando solo la descripción del ángulo o la pose, por ejemplo, frontal, de perfil, trasera, de medio cuerpo y de cuerpo entero, manteniendo una proporción fija de 3:4 o 1:1. Mantener la misma seed en cada imagen ayuda a reducir las diferencias aleatorias; la coherencia de estilo de la serie se mantiene principalmente gracias a la imagen de referencia junto con la descripción fija del sujeto.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: minimax-h3-image/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para minimax-h3-image/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria para reproducir el mismo resultado; usar un número entero, si se omite se utiliza una semilla aleatoria.

promptstringObligatoriominLength 1maxLength 5000pattern \S

Texto de instrucción de edición; debe referirse a las imágenes de referencia en orden como Picture 1, Picture 2, etc.; longitud de 1 a 5000 caracteres.

image_urlsarrayObligatoriominItems 1maxItems 16

Arreglo de imágenes de referencia para editar o componer; cada elemento es una URL de imagen; admite de 1 a 16 imágenes JPG, PNG o WEBP, de 128 a 8192 px por lado y máximo 20 MB por imagen; cada imagen de referencia se cobra por separado.

Array [ string ]

resolutionstringOpcionalPredeterminado: "2K"

Nivel de resolución de salida: 1K ≈ 1 MP, 2K ≈ 4 MP, 4K ≈ 16 MP; predeterminado 2K.

Opciones:1K2K4K

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de la imagen de salida; predeterminado auto, el modelo lo elige según el prompt y las imágenes de referencia.

Opciones:auto1:15:44:54:33:43:22:3

Mostrar todo (3)Mostrar menos

16:99:1621:9

output_formatstringOpcionalPredeterminado: "jpeg"

Formato de la imagen de salida; predeterminado jpeg; los archivos PNG son notablemente más grandes (2K ≈ 12 MB, 4K ≈ 30 MB).

Opciones:jpegpng

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-image/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "2K",
    "aspect_ratio": "auto",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-h3-image/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "2K",
      "aspect_ratio": "auto",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-h3-image/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "2K",
          "aspect_ratio": "auto",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}