Comment utiliser l'API Muse Image ? Générez votre première image en 5 minutes

TL;DR

• Muse Image 1.0 est un modèle d'image publié par Meta le 27 août 2026. Sur HiAPI, il dispose de deux points d'entrée : muse-image-1.0/text-to-image (texte vers image) et muse-image-1.0/image-to-image (retouche d'image, 1 à 10 images de référence). Ouvrez la page du modèle pour l'essayer en ligne.
• Les deux points d'entrée coûtent 0,015 $ par image. Chaque image fait environ 2,5 mégapixels, inutile de définir une résolution.
• La méthode la plus rapide : POST /v1/tasks avec prompt et aspect_ratio, puis interroger jusqu'à obtenir success et télécharger output[0].url. Les états d'échec fail et failed doivent tous deux être vérifiés.

En quoi Muse Image excelle-t-il ?

• Planifier avant de générer. Selon Meta, Muse Image réfléchit d'abord à la scène puis la dessine. À l'usage, des exigences de mise en page comme « generous negative space » et des noms de marque courts comme « DAWN » se retrouvent bien sur l'image.
• Illustrations, affiches, visuels produits, à 0,015 $ l'image, adapté aux contenus en grande série.
• Grand format par défaut : environ 2,5 mégapixels par image, par exemple environ 1920×1280 en 3:2 et environ 1600×1600 en 1:1.
• 8e du classement texte vers image d'Artificial Analysis.

Une description, une image finie, en 3:4 :

Editorial paper-cut illustration of a coral fox curled beneath a midnight-blue
tree, scattered warm stars, layered tactile paper edges, clear silhouette and
generous negative space, quiet book-cover composition, no text.

Générer avec ce prompt → (3:4)

muse-image-1.0/text-to-image, 3:4, 0,015 $.

Deux parcours pour démarrer

Essai en ligne (sans coder) :

1. Ouvrez la page texte vers image ou la page de retouche d'image, et connectez-vous (200 crédits offerts à l'inscription).
2. Collez le prompt, choisissez le format. Pour la retouche, téléversez 1 à 10 images.
3. Cliquez sur générer et téléchargez le résultat.

Appel via l'API :

1. Créez une API Key dans la console.
2. POST /v1/tasks avec l'un des deux noms de modèle.
3. Interrogez GET /v1/tasks/{taskId} ou recevez un callback, puis enregistrez output[0].url.

curl : générer la première image

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image-1.0/text-to-image",
    "input": {
      "prompt": "Editorial paper-cut illustration of a coral fox curled beneath a midnight-blue tree, warm stars, generous negative space, no text",
      "aspect_ratio": "3:4",
      "output_format": "png"
    }
  }'

La réponse contient data.taskId. Interrogez GET /v1/tasks/{taskId}, et une fois que status passe à success, téléchargez output[0].url.

Python : d'abord générer, puis retoucher

# pip install requests; export HIAPI_KEY=你的 Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def run(model, timeout_s=300, **inp):
    # 重试同一次提交时复用同一个 Idempotency-Key，只会扣一次费
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# 文生图，16:9 头图（$0.015）
header = run("muse-image-1.0/text-to-image",
             prompt="A sophisticated editorial illustration of a terracotta desert observatory under an oversized pale moon, winding turquoise river, no text",
             aspect_ratio="16:9", output_format="png")

# 把上一张改成夜景（$0.015）
night = run("muse-image-1.0/image-to-image",
            prompt="Turn the illustration into night: deep indigo sky, silver crescent moon, warm amber windows. Keep the buildings and river.",
            image_urls=[header], aspect_ratio="16:9", output_format="png")

with open("night.png", "wb") as f:
    f.write(requests.get(night).content)

Le lien de la première image est encore valide et accessible publiquement, elle peut donc être transmise directement comme image de référence. Pour conserver une image durablement, téléchargez-la d'abord.

Retoucher avec des images de référence

muse-image-1.0/image-to-image exige de transmettre image_urls (1 à 10 images). Attribuez un rôle à chaque image : ci-dessous, l'image 1 fournit le sujet baleine, l'image 2 ne sert que de modèle de mise en page, et tout l'ancien texte est remplacé.

Design a polished illustrated travel poster using the indigo whale and warm
stars from Image 1 as the central artwork. Borrow the cream paper, forest-green
framing and clean heading hierarchy from Image 2. Replace all old poster text
with a single large heading SEABOUND at the top and the smaller line STORIES
UNDER THE STARS below. Keep the whale recognizable, use balanced spacing and
delicate layered paper detail.

Ouvrir la page de retouche avec ce prompt → (téléversez vos deux propres images)

muse-image-1.0/image-to-image, deux images de référence, 0,015 $.

Le titre principal et le sous-titre sont identiques au caractère près, mais Muse a ajouté en bas une ligne de petits caractères non demandée. Lorsque le texte doit être exact, ajoutez « no other text » à la fin du prompt.

Paramètres en un coup d'œil

Champ	Valeurs	Description
prompt	chaîne, obligatoire, 5000 caractères maximum	Décrit la scène, ou précise ce qu'il faut modifier et conserver
image_urls	1 à 10 liens publics	Obligatoire pour la retouche ; inutile pour le texte vers image
aspect_ratio	1:1 4:3 3:4 16:9 9:16 3:2 2:3 21:9 9:21	Facultatif ; sans valeur, le modèle définit la composition selon le contenu de l'image
output_format	jpeg / png / webp, par défaut webp	Les trois au même prix

Il n'y a pas de champ resolution. Chaque image fait environ 2,5 mégapixels, la largeur et la hauteur varient selon le format.

À vérifier avant la mise en production

• Indiquez toujours aspect_ratio pour un emplacement fixe. Sans cette valeur, c'est le modèle qui décide ; acceptable en exploration, pas pour une bannière.
• Vérifiez à la fois fail et failed. La documentation indique failed ; vérifier les deux est plus sûr.
• Préférez le callback au polling : ajoutez "callback": {"url": "https://your-app.example.com/hiapi/callback"} au même niveau que input, et dédupliquez par taskId.
• Enregistrez le résultat immédiatement. output[0].url a une durée de validité ; téléchargez à temps ou choisissez le stockage permanent à la création de la tâche.
• Ajoutez l'en-tête Idempotency-Key ; lors d'une nouvelle tentative, la même clé ne crée la tâche qu'une seule fois.

Questions fréquentes

Combien d'images par tâche ?

1 image. Pour plusieurs directions, soumettez des tâches séparées.

Peut-on générer des images plus grandes ou plus petites ?

Non, Muse Image fait toujours environ 2,5 mégapixels. Pour du 4K, choisissez FLUX.3 Image ou Nano Banana 2.1.

Peut-on utiliser le point d'entrée de retouche sans image de référence ?

Non, la retouche exige de 1 à 10 images. Pour partir du texte, utilisez muse-image-1.0/text-to-image.

Une génération échouée est-elle facturée ?

Non. Seule une génération réussie est facturée.

Voir les tarifs sur Tarification de l'API Muse Image, d'autres prompts sur Exemples de prompts Muse Image, et une comparaison à prompt identique sur Muse Image vs Nano Banana 2.1. Vous pouvez aussi générer ce renard en papier découpé directement sur la page du modèle.