Saltar al contenido principal
POST

Autorizaciones

string
requerido
Todos los endpoints requieren autenticación con Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyInclúyala en el encabezado de la solicitud:

Body

string
predeterminado:"mai-image-2.7"
requerido
Nombre del modelo de generación de imágenesAmbos modelos tienen exactamente las mismas capacidades y parámetros.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de imagen.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción textual o instrucción de edición para generar la imagen
  • Admite chino e inglés, se recomiendan descripciones detalladas
  • Hasta 20.000 caracteres; si se supera, devuelve 400
  • No puede estar vacío ni contener solo espacios en blanco
integer
predeterminado:"1"
Número de imágenes a generarValor: 1
Solo se genera 1 imagen por solicitud; para varias imágenes, envíe tareas separadas. Los valores 0, negativos o mayores que 1 devuelven 400
string
predeterminado:"1:1"
Relación de aspecto o dimensiones en píxeles de la imagen; solo aplica a texto a imagenAdmite dos formatos:
  • Relación de aspecto: cualquier proporción de enteros entre 1:4 y 4:1, como 1:1, 16:9, 9:16, 21:9; junto con resolution determina los píxeles reales
  • Dimensiones en píxeles: anchoxalto (también admite ancho*alto y ancho×alto), como 2048x1152; en este caso se ignora resolution
Límites de las dimensiones en píxeles:
  • Ancho y alto ≥ 768
  • Ancho × alto ≤ 4.194.304 (2048×2048)
  • El ancho y el alto se redondean hacia abajo, cada uno, a un múltiplo de 32; por ejemplo, 1000x1000 produce 992x992
Ejemplos: ✅ 2048x2048, 2048x1152, 2560x1536; ❌ 512x512 (lado menor que 768), 2080x2048 (supera el total de píxeles)
No se admite auto; si se envía, devuelve 400
string
predeterminado:"1K"
Nivel de resolución de salida; solo aplica cuando size es una relación de aspectoOpciones: 1K / 2K (también en minúsculas)Correspondencia size × resolution → píxeles reales:
No se admite 4K; otros niveles devuelven 400. Como el lado corto debe ser al menos 768, las relaciones más alargadas que 2:1 superan aproximadamente 1 millón de píxeles en el nivel 1K.
integer
Ancho exacto en píxeles; debe enviarse junto con height
  • Máxima prioridad: si se envían, sustituyen a size y resolution
  • Mismos límites que las dimensiones en píxeles de size: ancho y alto ≥ 768, total de píxeles ≤ 4.194.304
  • Solo aplica a texto a imagen
integer
Alto exacto en píxeles; debe enviarse junto con width, con los mismos límites que width
array
Array de imágenes de referencia; si se proporciona, activa el modo imagen a imagen
  • 1 imagen para edición individual, varias imágenes para composición
string
Tipo de fondoOpciones: auto / opaque, con el mismo efecto que omitir el parámetro
El fondo transparente (transparent) aún no está disponible; enviar transparent u otro valor devuelve 400
No se admiten auto_aspect_ratio: true ni web_grounding: true; si se envían, devuelven 400. quality, style, output_format, response_format y mask_url no se admiten y se ignoran. La salida siempre es PNG.

Ejemplos de uso

Texto a imagen (solicitud mínima) Por defecto 1:1 + 1K, salida de 1024×1024.
Texto a imagen (con proporción + 2K)
Texto a imagen (píxeles exactos)
Edición individual
Composición de varias imágenes (URL + base64 combinados)

Response

integer
Código de estado de la respuesta
array
Array de datos de la respuesta

Consulta de resultados de la tarea

Tras un envío correcto, se devuelve un task_id. Consulte el estado de la tarea mediante GET /v1/tasks/{task_id}; consulte la API de consulta de tareas para más detalles. Se recomienda consultar cada 3–5 segundos, con un tiempo de espera total de 3 minutos.

Ejemplo de respuesta exitosa

Acceso a la imagen: data.result.images[0].url[0]. El enlace de la imagen caduca después de expires_at; descárguela y guárdela cuanto antes.

Estado de la tarea