Muse Image

Muse Image est le modèle d’image de Meta Superintelligence Labs. Une requête crée une image à partir d’un prompt, ou d’un prompt et de 9 images de référence au maximum, dans l’un des sept formats d’image. Envoyez la requête, conservez l’identifiant de tâche renvoyé et récupérez l’image terminée dans la tâche. Les images de référence sont transmises sous forme d’URL.

ID de modèle

Consultez la page du modèle pour les prix actuels.

Exemple rapide

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

Point de terminaison

POST https://api.seedrouter.ai/v1/images/generations

La réponse est une tâche ({"id": "task_...", "status": "processing"}), pas l’image terminée. Interrogez GET /v1/tasks/{task_id} pour obtenir le résultat. Gardez les clés API dans le code côté serveur. Les références sont transmises dans la même requête via image_urls ; /v1/images/edits n’est pas utilisé pour ce modèle.

Paramètres

Les champs ne figurant pas dans cette liste sont supprimés avant la transmission de la requête ; ils ne provoquent jamais d’erreur et ne modifient jamais la sortie. Aucun réglage de résolution, de seed, de prompt négatif, de masque ou de format de sortie n’est proposé. callback_url n’est pas disponible ; interrogez plutôt la tâche.

Images de référence

Passez jusqu’à 9 images dans image_urls et indiquez dans prompt ce qu’il faut conserver et modifier. Muse Image les utilise comme références pour une nouvelle image ; si aspect_ratio est omis, le résultat reprend leur format.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

Entrées média

Chaque référence est une URL HTTP(S) publique. Les data URI en base64 ne sont pas acceptées : téléversez le fichier sur votre propre stockage et transmettez son URL. Utilisez des images PNG, JPEG ou WebP ; les fichiers originaux de toutes les références doivent totaliser 11 Mo ou moins. Un ensemble dépassant cette limite échoue après acceptation et n’est pas facturé.

Facteurs de coût

Consultez la section tarifs du modèle pour les tarifs actuels. Muse Image a un prix unique par image :

cost = price per image × 1

Les requêtes avec texte seul ou avec références et tous les formats d’image coûtent le même prix. Le montant réservé à l’acceptation de la tâche est le montant facturé. Consultez les frais définitifs dans l’historique d’utilisation de votre compte. Les tâches échouées ne sont pas facturées.

Schéma de sortie

L’envoi renvoie la tâche :

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

Récupérer la tâche

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interrogez toutes les 10 à 20 secondes jusqu’à ce que status vaille completed ou failed. Un dépassement de délai réseau pendant l’interrogation ne signifie pas que la génération a échoué : conservez l’identifiant de tâche et reprenez la vérification. Ne créez pas une autre tâche pour vérifier l’avancement.

Tâche terminée

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

L’image est livrée en WebP, le format natif du modèle ; aucun réglage de format de sortie n’est proposé. Le modèle fixe les dimensions en pixels. Lors de nos tests, une requête avec texte seul a donné 1600 × 1600, 16:9 a donné 2048 × 1152, 3:4 a donné 1344 × 1792 et 9:16 a donné 1152 × 2048, environ 50 à 180 secondes après l’envoi.

Erreurs

Les requêtes rejetées avant la création d’une tâche renvoient une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation renvoie HTTP 200 lorsqu’on l’interroge, avec status: "failed" et un objet error.

Voir le catalogue d’erreurs commun pour les codes, les statuts HTTP et les conseils de reprise.

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si l’envoi lui-même dépasse le délai, vérifiez vos tâches avant de renvoyer : la première requête a peut-être été acceptée.

Conseils

• Nommez le sujet, le décor, la lumière et le cadrage ; Muse Image suit fidèlement un brief précis.
• Avec des références, indiquez exactement ce qui doit rester identique, comme la couleur ou la forme du produit.
• Omettez aspect_ratio pour reprendre le format d’une référence ; définissez-le pour recadrer selon un canal.
• Ajoutez no text, no logos pour éviter les marques inventées.

Ressources liées

• Playground et tarifs de Muse Image
• Référence de l’API Muse Video
• Télécharger l’OpenAPI
• Markdown copiable