Felo API PlatformFelo API Platform
Retour aux modèles

Microsoft AI: MAI-Image-2.7 Flash API

MAI-Image-2.7 Flash génère et édite rapidement des images à partir de texte, d’images et de références stylistiques ou visuelles.

MAI-Image-2.7 Flash est un modèle de Microsoft AI fondé sur la diffusion, conçu pour la génération d’images à partir de texte et l’édition précise d’images existantes. Il accepte du texte et des images en entrée, avec un contexte de32,000 tokens, et peut produire des visuels guidés par jusqu’à5 images de référence de style ou de sujet. La sortie est toujours une image PNG, renvoyée dans un objet JSON encodé en base64.

Il convient aux outils créatifs interactifs, aux pipelines itératifs et à la génération en volume lorsque la rapidité compte davantage qu’une finition en qualité4K. Il peut nettoyer des photos de produits, créer des arrière-plans transparents, remplacer des objets, modifier une couleur ou un matériau, et produire des devantures, enseignes ou visuels marketing avec du texte correctement rendu. Il privilégie la vitesse au détriment d’une partie de la fidélité et se limite à la génération et à l’édition d’images, sans raisonnement textuel, utilisation d’outils ni recherche web.

Les images de référence doivent être au format JPEG ou PNG, et l’édition accepte jusqu’à5 images. La largeur et la hauteur de l’image produite doivent être chacune d’au moins768 pixels. Pour les modifications locales, il est recommandé de préciser explicitement la zone à éditer. Le modèle est proposé en aperçu public et sert de modèle par défaut pour Bing Image Creator.

Mis à jour:

ID DU MODÈLE

mai-image-2.7-flash
Contexte
4.096K
Sortie max.
1.024K
Entrée
text / image
Sortie
image

Points clés

  • Génération diffusion rapide
  • Édition image contrôlable
  • Jusqu’à5 références
  • Sortie PNG en base64
  • Contexte de32,000 tokens

Fournisseurs

1 fournisseurs

Comparez les prix des API entre fournisseurs. Sélectionnez un fournisseur pour voir tous les tarifs et conditions.

Fournisseur · Détails des tarifs
Disponibilité

Benchmarks

  • Classement Artificial Analysis — édition d’image

    7e place dans le classement.

    7
  • Classement Artificial Analysis — génération texte-vers-image

    11e place dans le classement.

    11
  • Artificial Analysis — édition de scènes et de styles

    3e place dans le classement.

    3
  • Artificial Analysis — amélioration et restauration

    4e place dans le classement.

    4

Scores tels que publiés par le fournisseur du modèle.

Démarrage rapide

Envoyez une tâche image, consultez son état, puis enregistrez les images. Les exemples utilisent curl et la bibliothèque standard de Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Configurer votre clé API

Créez une clé depuis votre compte Felo API Platform et définissez-la comme variable d'environnement.

export FELO_API_KEY="YOUR_API_KEY"

2Effectuer votre première requête

Les valeurs facultatives dépendent du modèle et ne sont pas prédéfinies ici. Vérifiez-les dans Playground. Les champs sont au même niveau que model et prompt, sans enveloppe input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "mai-image-2.7-flash"
}'

3Interroger la tâche

La soumission renvoie task_id. Interrogez toutes les 3 secondes pendant queued ou running ; arrêtez à succeeded, failed ou interrupted. Attente maximale : 30 minutes. Gardez created.json pour reprendre sans soumettre une nouvelle tâche.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Télécharger la sortie

Après réussite, enregistrez outputs depuis task.json : URL HTTPS, objets URL ou b64_json. Téléchargez rapidement les URL signées. Le téléchargement des images ne nécessite pas de clé API.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Pour modifier une image, remplacez l’URL par votre URL HTTPS ou une data URL d’image en base64. Soumettez une fois, puis suivez les mêmes étapes de consultation et d’enregistrement.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "mai-image-2.7-flash",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Paramètres pris en charge

  • n
  • background
  • max_tokens
  • temperature
  • aspect_ratio
  • input_references
  • max_completion_tokens

Besoin de la référence complète ?

Référence API →

Questions fréquentes

Qu'est-ce que Microsoft AI: MAI-Image-2.7 Flash?

MAI-Image-2.7 Flash est un modèle de Microsoft AI fondé sur la diffusion, conçu pour la génération d’images à partir de texte et l’édition précise d’images existantes. Il accepte du texte et des images en entrée, avec un contexte de32,000 tokens, et peut produire des visuels guidés par jusqu’à5 images de référence de style ou de sujet. La sortie est toujours une image PNG, renvoyée dans un objet JSON encodé en base64. Il convient aux outils créatifs interactifs, aux pipelines itératifs et à la génération en volume lorsque la rapidité compte davantage qu’une finition en qualité4K. Il peut nettoyer des photos de produits, créer des arrière-plans transparents, remplacer des objets, modifier une couleur ou un matériau, et produire des devantures, enseignes ou visuels marketing avec du texte correctement rendu. Il privilégie la vitesse au détriment d’une partie de la fidélité et se limite à la génération et à l’édition d’images, sans raisonnement textuel, utilisation d’outils ni recherche web. Les images de référence doivent être au format JPEG ou PNG, et l’édition accepte jusqu’à5 images. La largeur et la hauteur de l’image produite doivent être chacune d’au moins768 pixels. Pour les modifications locales, il est recommandé de préciser explicitement la zone à éditer. Le modèle est proposé en aperçu public et sert de modèle par défaut pour Bing Image Creator.

Comment l'usage est-il facturé ?

Votre facture dépend du fournisseur utilisé, de ses tarifs et de votre usage. Des entrées plus longues ou d'autres conditions peuvent avoir des tarifs différents. Facturé selon le coût réel de génération. Consultez votre facture pour le montant final.

Quels types d’entrées sont pris en charge ?

Le modèle accepte du texte et des images en entrée. Les images de référence doivent être au format JPEG ou PNG.

Quelle taille de contexte est disponible ?

Le contexte est de32,000 tokens. La limite de sortie n’est pas indiquée dans les informations fournies.

Pour quelles tâches ce modèle est-il adapté ?

Il convient à la génération texte-vers-image, à l’édition d’images, au nettoyage de photos de produits, aux itérations de design et à la création guidée par références.

Comment les images sont-elles renvoyées ?

La sortie est toujours au format PNG, dans un objet JSON encodé en base64.

Quelles sont ses principales limites ?

Il sacrifie une partie de la fidélité au profit de la vitesse et ne fournit ni raisonnement textuel, ni utilisation d’outils, ni recherche web. La largeur et la hauteur de sortie doivent chacune atteindre au moins768 pixels.

Quelle est sa différence avec les modèles apparentés ?

MAI-Image-2.7 Flash est la variante plus rapide et moins coûteuse de MAI-Image-2.7, tandis que MAI-Image-2.6-Flash et MAI-Image-2.6 appartiennent à une génération antérieure.

Modèles liés