API de MiniMax H3 Image
Referencia completa de la API de los modelos de generación de imágenes a partir de texto y edición de imágenes MiniMax H3 Image.
Variantes del modelo
Esta API admite dos variantes del modelo:
Comparación rápida
Relaciones de aspecto admitidas
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Indique la relación mediante valores numéricos separados de width y height, no mediante dimensiones en píxeles. Si se omiten ambos valores, la relación predeterminada es 1:1; de lo contrario, indique ambos valores utilizando uno de los pares de enteros admitidos.
MiniMax H3 Image (Texto a imagen)
Punto de conexión
POST /api/v1/image/task
Autenticación
Authorization: Bearer YOUR_API_KEY
Parámetros de la solicitud
Obligatorios
Opcionales
Nota: La relación width:height debe ser una de las 15 relaciones admitidas indicadas anteriormente.
Ejemplo de solicitud
javascript
MiniMax H3 Image Edit (Edición de imágenes)
Punto de conexión
POST /api/v1/image/task
Parámetros de la solicitud
Obligatorios
Opcionales
Nota: La relación width:height debe ser una de las 15 relaciones admitidas indicadas anteriormente.
Ejemplo de solicitud
javascript
Ejemplo de edición de una sola imagen
javascript
Ejemplo de composición de varias imágenes
javascript
Formato de respuesta
Respuesta inicial
json
Respuesta de consulta periódica
Consulte periódicamente GET /api/v1/image/{task_id} para comprobar el estado. Las respuestas correctas de estas consultas incluyen las URL de las imágenes generadas en data.task_result.images[].url.
Valores de estado
submitted: Tarea aceptadaprocessing: Generación de imagen en cursosucceed: Generación de imagen completadafailed: Error en la generación de imagen
Buenas prácticas
- Instrucciones detalladas: Describa el sujeto, la iluminación y la composición, limitando las instrucciones a 5000 caracteres
- Selección de resolución: Incluya explícitamente
1k,2ko4ken cada solicitud - Relación de aspecto: Utilice valores de relación emparejados para
widthyheight, u omita ambos para obtener1:1 - Calidad de la edición: Proporcione 1-16 imágenes de referencia que cumplan los requisitos de formato y dimensiones admitidos