MiniMax
MiniMax H3 Image
minimax-h3-image/text-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
Probar minimax-h3-image/text-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
minimax-h3-image/text-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 1K | $0.0129 |
| 2K | $0.0129 |
| 4K | $0.0393 |
Descripción general
Este es un modelo que genera imágenes estáticas a partir de una descripción textual. Solo necesitas introducir un prompt para obtener una imagen acorde con la descripción, y puedes controlar el nivel de resolución, la relación de aspecto y el formato de salida de la imagen. Cuando sea necesario, también puedes fijar una semilla aleatoria para que el resultado generado con el mismo prompt y la misma configuración sea reproducible. Está orientado a diseñadores, creadores de contenido y desarrolladores que necesitan materializar sus ideas rápidamente, y es adecuado para crear imágenes conceptuales, imágenes de ambientación de escenas y todo tipo de recursos visuales.
Aspectos destacados
- Expansión automática del prompt: el prompt enviado se amplía automáticamente añadiendo más detalles, lo que ayuda a obtener una representación visual más rica.
- Varios niveles de resolución disponibles: la resolución de salida se puede elegir entre tres niveles, 1K, 2K y 4K, que corresponden aproximadamente a 1, 4 y 16 megapíxeles.
- Compatibilidad con múltiples relaciones de aspecto: incluye varias relaciones desde 1:1 hasta 21:9, y también admite la selección automática, adaptándose a distintas necesidades de maquetación.
- Semilla fija reproducible: al establecer una semilla entera entre 0 y 2147483647, se pueden reproducir los resultados con el mismo prompt y los mismos parámetros.
Descripción de capacidades
Generación de imágenes a partir de texto: se introduce un prompt que describe la escena y el modelo genera una imagen estática a partir de él. El prompt debe tener como mínimo 1 carácter y como máximo 5000 caracteres.
Control del nivel de resolución: se puede elegir la resolución de salida entre tres niveles, 1K, 2K y 4K, que corresponden aproximadamente a 1, 4 y 16 megapíxeles; el valor predeterminado es 2K.
Control de la relación de aspecto: admite 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9 y la relación automática; el valor predeterminado es 1:1.
Selección del formato de salida: se puede elegir el formato de salida JPEG o PNG; los archivos PNG ocupan más espacio, aproximadamente 12 MB en 2K y unos 30 MB en 4K.
Semilla aleatoria fija: se ofrece una semilla entera de 0 a 2147483647 para facilitar la reproducción de resultados con el mismo prompt y los mismos parámetros; si no se establece, se genera de forma aleatoria.
Casos de uso
- Diseñadores conceptuales que dibujan personajes y escenas: introducen una descripción textual de un personaje o una escena y generan imágenes conceptuales estilizadas para propuestas preliminares y desarrollo visual.
- Creadores de contenido que elaboran ilustraciones: redactan prompts a partir del tema de un artículo o un vídeo y generan imágenes adaptadas a la maquetación para usarlas directamente en la publicación de contenido.
- Producción de recursos visuales comerciales: seleccionan el nivel 4K y una relación de aspecto amplia para generar recursos de alta resolución destinados a materiales publicitarios o de exhibición.
- Desarrolladores que generan imágenes por lotes: mediante combinaciones de semillas fijas y parámetros, generan por lotes recursos de imagen reproducibles e integrables en flujos de diseño o contenido.
Limitaciones y recomendaciones de selección
El prompt es obligatorio, admite como máximo 5000 caracteres y no puede contener solo espacios en blanco. El nivel de resolución, la relación de aspecto y el formato de salida se eligen entre valores de enumeración, sin admisión de valores personalizados. La semilla está limitada a un entero entre 0 y 2147483647. El resultado generado es una imagen estática y cada solicitud produce una imagen.
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
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
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl 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-KeystringOpcionalClave 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.
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
modelstringObligatorioValor fijo actual: minimax-h3-image/text-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para minimax-h3-image/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.
seedintegerOpcionalmin 0max 2147483647Semilla aleatoria fija para hacer reproducibles los resultados; debe ser un número entero; si se omite, se usa una semilla aleatoria.
promptstringObligatoriominLength 1maxLength 5000pattern \SIndicación de descripción de la imagen, longitud de 1 a 5000 caracteres; la indicación se amplía automáticamente para mostrar detalles más ricos.
resolutionstringOpcionalPredeterminado: "2K"Nivel de resolución de salida: 1K ≈ 1 MP, 2K ≈ 4 MP, 4K ≈ 16 MP; por defecto 2K.
1K2K4Kaspect_ratiostringOpcionalPredeterminado: "1:1"Relación de aspecto de salida; si se establece en auto, el modelo la elige por sí mismo; por defecto 1:1.
auto1:15:44:54:33:43:22:3Mostrar todo (3)Mostrar menos
16:99:1621:9output_formatstringOpcionalPredeterminado: "jpeg"Formato de imagen de salida, por defecto jpeg; los archivos PNG son considerablemente más grandes (2K ≈ 12 MB, 4K ≈ 30 MB).
jpegpngcallbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
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.
urlstringObligatorioObligatorio 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.
finalstoragestringOpcionalPredeterminado: "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.
temppersistentEjemplos 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/text-to-image",
"input": {
"prompt": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"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/text-to-image",
input: {
"prompt": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"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/text-to-image",
"input": {
"prompt": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"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
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre 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.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
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.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos 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
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripció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"
}
}
} Artículos
Ver todos los artículos →Modelos relacionados
Ver todos los modelos →Mismo tipo
-
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
Ideogram V3 Character Ideogram $0.090 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
Ideogram V4.5 Ideogram $0.011 /imagen -
Seedream 5.0 ByteDance $0.025 /imagen -
Z-Image Alibaba $0.008 /imagen -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
Grok Imagine xAI $0.011 /segundo -
MiniMax H3 Image MiniMax $0.013 /imagen -
Google Virtual Try-On Google $0.107 /imagen -
GPT Image 2.6 OpenAI $0.023 /imagen -
Imagen 4 Google $0.030 /imagen



