Saltar al contenido principal
POST

Autenticación

string
requerido
Todos los endpoints usan Bearer Token. Obtén tu clave en la página de claves de API.

Acerca de los modelos

MiniMax H3 Image destaca en fotografía realista, carteles, imágenes de producto y escenas con texto. De forma predeterminada, amplía automáticamente el prompt en una descripción detallada de la escena antes de generar la imagen. El texto ampliado se puede ver en revised_prompt en el resultado de la consulta. Para generar siguiendo exactamente el texto original, consulta Desactivar la optimización del prompt.
Si no se envía resolution, la salida predeterminada es 4K (unos 16 megapíxeles), con un precio unitario de aproximadamente 3,6 veces el de 1K / 2K. Si no necesitas 4K, envía explícitamente "resolution": "2K".

Parámetros de solicitud

string
requerido
Nombre del modelo de generación de imágenes, fijo en minimax-h3-image-highspeed.
string
requerido
Descripción en texto de la imagen que se generará o editará.Admite chino e inglés. Tras eliminar los espacios al inicio y al final, debe tener entre 1 y 32,000 caracteres.
string[]
Array de imágenes de referencia, hasta 16. Si se envía, se activa automáticamente el modo de edición.Cada elemento puede ser un enlace directo http(s):// accesible públicamente o Base64 en línea con el formato data:image/png;base64,... (la plataforma lo convierte primero en un enlace antes de pasarlo al modelo).Consulta Requisitos de las imágenes de referencia.
string
predeterminado:"auto"
Relación de aspecto o dimensiones exactas en píxeles de la imagen de salida.Valores admitidos:
  • auto: el modelo decide la composición y la proporción según el prompt
  • Relación de aspecto: formato X:Y, con X e Y enteros de 1 a 300 y una proporción entre 1:3 y 3:1 (ambos incluidos), como 1:1, 4:3, 16:9, 9:16, 3:1
  • Píxeles exactos: anchoxalto, como 2048x1152 (también admite los separadores X, ×, *)
Consulta Reglas de tamaño.
string
predeterminado:"4K"
Nivel de resolución; junto con la relación de aspecto determina los píxeles reales de salida.
  • 1K: unos 1 megapíxel
  • 2K: unos 4,2 megapíxeles
  • 4K (predeterminado): unos 16 megapíxeles
También admite minúsculas.
Cuando size usa píxeles exactos, no se puede enviar resolution; de lo contrario, se devuelve 400.
integer
predeterminado:"1"
Número de imágenes que se generarán, de 1 a 10.
boolean
predeterminado:"true"
Indica si el prompt se amplía automáticamente.false solo se aplica a texto a imagen y requiere indicar un tamaño explícito; consulta Desactivar la optimización del prompt.
string
predeterminado:"jpeg"
Formato del archivo de salida.
  • jpeg (predeterminado; también se admite jpg)
  • png
  • webp
integer
predeterminado:"95"
Calidad de compresión, de 0 a 100. No se aplica a png.
boolean
predeterminado:"false"
Indica si se añade a la imagen una marca de agua visible de contenido generado por IA. No afecta a la identificación implícita en los metadatos de la imagen.
Los siguientes parámetros no se admiten y se ignoran si se envían: quality, style, seed, negative_prompt, background, mask_url.Los resultados siempre se devuelven como URL; enviar response_format: "b64_json" devuelve 400.

Reglas de tamaño

Nivel + relación de aspecto

El nivel determina el área total y la relación de aspecto determina la forma: El modelo redondea los píxeles reales de salida según la proporción y el nivel; el valor devuelto es el que cuenta. Para dimensiones exactas, usa el formato en píxeles.

Píxeles exactos

Al usar size: "anchoxalto", deben cumplirse estas condiciones:
  • ✅ 1024x1024, 2048x1152, 1536x1536, 4000x5000
  • ❌ 512x512 (área demasiado pequeña), 4000x1000 (proporción superior a 3:1), 5000x5000 (más de 20 megapíxeles)

Requisitos de las imágenes de referencia

Al usar URL, asegúrate de que el enlace sea accesible públicamente. Si no se puede acceder al enlace, la tarea fallará en la fase de generación (status será failed y se reembolsará el importe completo).En el modo de edición, la optimización del prompt está siempre activada y no se puede desactivar.

Desactivar la optimización del prompt

De forma predeterminada, el modelo amplía el prompt antes de generar la imagen. Para generar siguiendo exactamente el texto original, envía "prompt_optimizer": false, siempre que:
  • Se use solo para texto a imagen; con image_urls se devuelve 400
  • Se indique un tamaño explícito: size debe ser una relación de aspecto (como 1:1) o píxeles (como 1024x1024), no auto ni omitido
Con la optimización desactivada, el modelo solo lee aproximadamente los primeros 4096 tokens del prompt.

Response

integer
Código de respuesta; 200 cuando el envío es correcto.
array
Datos de la respuesta del envío.

Respuesta del envío

Tras un envío correcto, se devuelve de inmediato el ID de la tarea asíncrona:

Consultar el resultado de la tarea

Usa el task_id de la respuesta del envío para llamar a la API de consulta de tareas:
La versión rápida genera imágenes más rápido que la estándar (en pruebas, la versión estándar tarda unos 10 a 20 segundos por imagen 1K / 2K y unos 20 segundos en 4K). Se recomienda consultar cada 3 a 5 segundos hasta que el estado cambie a completed o failed. Una tarea puede ejecutarse hasta 600 segundos; configura el timeout de sondeo del cliente en 10 minutos.

Tarea completada

Las URL de las imágenes están en data.result.images[0].url[], con las n imágenes en este único array. Descárgalas y guárdalas antes de expires_at. Si la tarea falla, status será failed, el motivo aparecerá en error.message y el importe se reembolsará íntegramente de forma automática.

Ejemplos de uso

Texto a imagen (4K predeterminado)

Texto a imagen (1K + relación de aspecto, 4 imágenes)

Píxeles exactos + PNG

Edición con imágenes de referencia

Desactivar la optimización del prompt