Préparez vos modifications pour le modèle d’édition d’images Microsoft MAI Image 2.7. Dans le Playground MAI Image API, associez l’original à des consignes précises sur la scène, la lumière, le texte et les détails à conserver.
Configuration MAI Image 2.7 API
Précisez les éléments à modifier et les détails à conserver.
Choisissez une image et décrivez les modifications.
Partez de votre image et d’un objectif précis. Dans l’espace de travail, distinguez les modifications souhaitées de la composition, des matières et des détails à conserver.
Ces exemples montrent comment préparer une requête de retouche avec une image source et une consigne, puis interroger la tâche pour en récupérer le résultat.
Enregistrez votre clé API APIMart dans la variable d’environnement APIMART_API_KEY. Envoyez-la avec Authorization: Bearer <key> lors de la soumission de la retouche et de la consultation de la tâche.
Envoyez POST /v1/images/generations avec model défini sur mai-image-2.7, une consigne de retouche dans prompt et une URL HTTP ou HTTPS de l’image source dans image_urls. Récupérez l’identifiant de tâche dans data[0].task_id de la réponse.
Interrogez la tâche avec GET /v1/tasks/{task_id}. Si son statut est completed, lisez l’URL de l’image dans data.result.images[0].url[0]. Si le statut est failed, consultez la raison dans data.error.message.
Consultez la documentation APIMart pour l’authentification et l’utilisation générale de l’API 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": "Placez le produit de cette image sur un plan de travail en marbre, dans une douce lumière matinale, en conservant sa forme et son étiquette.",
"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": "Placez le produit de cette image sur un plan de travail en marbre, dans une douce lumière matinale, en conservant sa forme et son étiquette.",
"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"| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
model | string | Oui | Par défaut: mai-image-2.7 | Valeur du modèle utilisée dans l’exemple de cette page : mai-image-2.7. |
prompt | string | Oui | Par défaut: — | Décrivez les modifications souhaitées et les éléments de l’image source à conserver. |
image_urls | array | Oui | Par défaut: — | Un tableau contenant exactement une URL HTTP ou HTTPS de l’image source à modifier. |
Organisez les changements visuels importants pour votre image.
Préparez des consignes concrètes pour vos visuels existants.
Vérifiez ensemble image et consignes en trois étapes.
Sélectionnez l’original depuis un fichier local ou une URL d’image HTTP/HTTPS.
Décrivez la modification principale, puis listez objets, texte, textures ou zones à conserver.
Contrôlez la source et le prompt dans Form ou JSON. Supprimez les contradictions avant d’affiner le projet.
Images sources, prompts de retouche et configuration de l’espace de travail.
MAI Image 2.7 est le modèle de retouche d’image de Microsoft. L’espace MAI Image API organise sources et consignes pour modifier scène, style, lumière, texte ou restaurer des images.
Choisissez une image source et décrivez la modification dans le prompt mai-image-api. Ajoutez des consignes explicites sur les détails importants à conserver.
L’espace MAI Image API permet de choisir une image source depuis un fichier local ou un lien. Remplacez l’original actuel pour préparer la retouche d’une autre image.
Indiquez d’abord la modification principale dans le prompt API, puis le décor, la lumière et les contraintes. Préférez des consignes précises à plusieurs objectifs contradictoires.
Nommez forme du produit, traits du visage, matières, texte ou zones à conserver dans le prompt API. Ce sont des orientations de retouche, sans garantie de préservation exacte.
Décrivez le nouvel environnement dans le projet MAI Image API en précisant position et échelle du sujet. Ajoutez ombres de contact et perspective pour clarifier les relations souhaitées.
Pour MAI Image API, décrivez direction, douceur, couleur et ambiance lumineuses. Indiquez les ombres et reflets à modifier ainsi que les éléments à garder cohérents.
Décrivez médium, couleurs et textures dans le prompt MAI Image API. Identifiez sujet, pose et composition à conserver plutôt que de vous limiter à un style vague.
Placez le texte de remplacement exact entre guillemets dans le prompt API. Précisez position et surface ; orthographe, alignement et lisibilité restent à vérifier.
Indiquez à Microsoft MAI Image API les rayures, décolorations ou défauts à corriger. Précisez les traits du visage, textures, matières et éléments de la scène originale à conserver.
Utilisez des positions relatives claires dans le prompt MAI Image API : à gauche, derrière, en contact ou en chevauchement. Ajoutez échelle, perspective et objets environnants comme repères.
L’espace MAI Image API permet de sélectionner une image locale ou une URL HTTP/HTTPS. Utilisez une adresse pointant vers l’image elle-même, et non une page web.
Form et JSON décrivent le même brouillon MAI Image API. Un JSON valide met à jour le formulaire ; sinon, un message apparaît et le texte modifié ainsi que l’ancien brouillon sont conservés. La valeur mai-image-2.7 est l’identifiant de configuration de cette page.
Reset efface l’image source et le prompt actuels de l’espace MAI Image API et restaure la configuration initiale. Copiez d’abord les consignes à conserver.
Les noms utilisés dans les titres de cette page sont des variantes d’écriture, pas des identifiants de requête API. MAI Image 27, MAIImage 2.7 et MAI-Image2.7 sont des graphies utilisées dans les recherches, pas des modèles distincts ni des identifiants API. Ici, mai-image-2.7 est l’identifiant de configuration de la page ; vérifiez les identifiants de requête dans la documentation de l’API concernée.
Connectez-vous à APIMart et ouvrez la gestion des clés via l’entrée API Keys en haut de cette page. Vous pouvez y créer et gérer une clé API APIMart. Consultez la documentation de l’API concernée pour les exigences d’authentification et les identifiants de requête.
Découvrez d'autres modèles de la même catégorie.

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.