Planifica cambios con el modelo de edición de imágenes Microsoft MAI Image 2.7. Combina el original con instrucciones claras de escena, luz, texto y detalles a conservar en el Playground de MAI Image API.
Configuración de MAI Image 2.7 API
Indica qué debe cambiar y qué detalles deben conservarse.
Elige una imagen y describe los cambios.
Empieza con tu imagen y un objetivo claro. Usa el espacio de edición para separar los cambios deseados de la composición, los materiales y los detalles que deben mantenerse.
Usa estos ejemplos para preparar una solicitud de edición con la imagen original y las instrucciones, y después consulta la tarea para obtener el resultado.
Guarda tu clave API de APIMart en la variable de entorno APIMART_API_KEY. Envíala como Authorization: Bearer <key> tanto al solicitar la edición como al consultar la tarea.
Envía POST /v1/images/generations con model definido como mai-image-2.7, las instrucciones de edición en prompt y una URL HTTP o HTTPS de la imagen original en image_urls. Lee el ID de la tarea en data[0].task_id de la respuesta.
Consulta la tarea con GET /v1/tasks/{task_id}. Si su estado es completed, lee la URL de la imagen en data.result.images[0].url[0]. Si el estado es failed, consulta el motivo en data.error.message.
Consulta la documentación de APIMart para conocer la autenticación y el uso general de la API de APIMart.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mai-image-2.7",
"prompt": "Coloca el producto de esta imagen sobre una encimera de cocina de mármol con luz suave de la mañana, manteniendo su forma y su etiqueta sin cambios.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "mai-image-2.7",
"prompt": "Coloca el producto de esta imagen sobre una encimera de cocina de mármol con luz suave de la mañana, manteniendo su forma y su etiqueta sin cambios.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| Parámetro | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|
model | string | Sí | Por defecto: mai-image-2.7 | Valor del modelo utilizado en el ejemplo de esta página: mai-image-2.7. |
prompt | string | Sí | Por defecto: — | Describe los cambios que quieres hacer y los elementos de la imagen original que deben conservarse. |
image_urls | array | Sí | Por defecto: — | Un array que contiene exactamente una URL HTTP o HTTPS de la imagen original que se va a editar. |
Organiza los cambios visuales importantes para tu imagen.
Prepara instrucciones concretas para imágenes existentes.
Revisa la imagen y las instrucciones juntas en tres pasos.
Selecciona la imagen original desde un archivo local o una URL de imagen HTTP/HTTPS.
Describe el cambio principal y enumera objetos, texto, texturas o zonas que deben mantenerse.
Comprueba el original y el prompt en Form o JSON. Elimina instrucciones contradictorias antes de afinar la idea.
Imágenes originales, prompts de edición y configuración del espacio de trabajo.
MAI Image 2.7 es el modelo de edición de imágenes de Microsoft. El espacio de MAI Image API organiza originales e instrucciones para cambios de escena, estilo, luz, texto y restauración.
Elige una imagen original y describe el cambio deseado en el prompt de mai-image-api. Añade instrucciones explícitas para los detalles importantes que deben mantenerse.
El espacio de MAI Image API permite elegir una imagen original desde un archivo local o enlace. Sustituye el original actual para preparar la edición de otra imagen.
Indica primero el cambio principal en el prompt de la API y después el entorno, la luz y las condiciones. Prioriza instrucciones concretas frente a objetivos contradictorios.
Enumera forma del producto, rasgos faciales, materiales, letras o zonas que deban conservarse en el prompt de la API. Son instrucciones, no garantías de conservación exacta.
Describe el entorno nuevo en tu idea de MAI Image API e indica posición y escala del sujeto. Incluye sombras de contacto y perspectiva para aclarar la relación deseada.
Para MAI Image API, describe dirección, suavidad, color y ambiente de la luz. Indica qué sombras y reflejos cambian y qué partes deben mantenerse coherentes.
Describe el medio, los colores y la textura en el prompt de MAI Image API. Identifica sujeto, postura y composición a conservar en lugar de usar una etiqueta de estilo vaga.
Escribe el texto de reemplazo exacto entre comillas en el prompt de la API. Indica posición y superficie; revisa cuidadosamente ortografía, alineación y legibilidad.
Indica a Microsoft MAI Image API qué arañazos, pérdida de color o artefactos corregir. Especifica los rasgos faciales, texturas, materiales y elementos de la escena original que deben mantenerse.
Usa posiciones relativas claras en el prompt de MAI Image API: izquierda, detrás, en contacto o superpuesto. Incluye escala, perspectiva y objetos del entorno como referencia.
El espacio de MAI Image API permite elegir una imagen local o una URL HTTP/HTTPS. Usa una dirección que apunte al archivo de imagen, no a una página web.
Form y JSON describen el mismo borrador de MAI Image API. El JSON válido actualiza el formulario; los errores muestran un aviso conservando el texto y el borrador anterior. El valor mai-image-2.7 es el ID de configuración de esta página.
Reset elimina la imagen original y el prompt de edición actuales del espacio de MAI Image API y restaura la configuración inicial. Copia primero las instrucciones que quieras conservar.
Los nombres usados en los títulos de esta página son variantes de escritura, no identificadores para solicitudes de API. MAI Image 27, MAIImage 2.7 y MAI-Image2.7 son variantes de búsqueda, no modelos distintos ni ID de API. Aquí, mai-image-2.7 es el ID de configuración de la página; comprueba los identificadores de las solicitudes en la documentación de la API correspondiente.
Inicia sesión en APIMart y abre la gestión de claves desde API Keys en la parte superior de esta página. Allí puedes crear y gestionar una clave de API de APIMart. Consulta la documentación de la API correspondiente para los requisitos de autenticación y los identificadores de las solicitudes.
Explora más modelos de la misma categoría.

MiniMax H3 Image
Built for image quality and prompt adherence. It handles text-to-image, reference-based generation and image editing. MiniMax says it can generate a 4K (4096 × 4096) image in under 10 seconds and work with up to 16 reference images. In Chinese launch coverage, MiniMax puts its speed at about 1.5 to 2 times that of mainstream tools.

MiniMax H3 Image Highspeed
Built for speed. The same coverage puts it at about 3 to 4 times faster than mainstream tools, which suits batch jobs or anything that needs fast turnaround.

Seedream 5.5
Seedream 5.5 brings your imagination to life through expressive visuals. From dreamy illustrations to cinematic scenes and product concepts, explore color, texture, and light to shape images that tell your story.

GPT Image 2.6 Sunburst
GPT Image 2.6 Sunburst brings a fresh burst of creativity to your ideas. From vibrant illustrations to atmospheric scenes and striking product concepts, explore rich colors, expressive lighting, and thoughtful compositions that make your vision shine.