curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "Una hermosa puesta de sol colorida sobre el océano"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax

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
Los enlaces de las imágenes generadas son válidos durante 24 horas. Guarde los resultados cuanto antes

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "Una hermosa puesta de sol colorida sobre el océano"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:minimax-h3-image

requerido

Nombre del modelo de generación de imágenes. El canal oficial ofrece mayor estabilidad y control para uso comercial

Opciones disponibles:

minimax-h3-image

Ejemplo:

"minimax-h3-image"

prompt

string

requerido

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

Maximum string length: 32000

Ejemplo:

"Una hermosa puesta de sol colorida sobre el océano"

image_urls

string<uri>[]

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

Ejemplo:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

size

string

predeterminado:auto

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

Ejemplo:

"auto"

resolution

enum<string>

predeterminado:2K

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

Opciones disponibles:

1K,

2K,

4K

Ejemplo:

"2K"

output_format

enum<string>

predeterminado:jpeg

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

Opciones disponibles:

jpeg,

png,

webp

Ejemplo:

"jpeg"

integer

predeterminado:1

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

Rango requerido: 1 <= x <= 10

Ejemplo:

1

prompt_extend

boolean

predeterminado:true

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

Ejemplo:

true

callback_url

string<uri>

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

Ejemplo:

"https://your-domain.com/webhooks/image-task-completed"

Respuesta

Tarea de imagen creada con éxito

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757156493

string

ID de tarea

Ejemplo:

"task-unified-1757156493-imcg5zqt"

model

string

Nombre del modelo usado realmente

Ejemplo:

"minimax-h3-image"

object

enum<string>

Tipo específico de tarea

Opciones disponibles:

image.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información de tarea asíncrona

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"image"

usage

object

Información de uso y facturación

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

MiniMax H3 Image Generación de imágenes

Autorizaciones

Cuerpo

Respuesta