Muse Image

Muse Image è il modello di immagini di Meta Superintelligence Labs. Una richiesta crea un’immagine da un prompt, oppure da un prompt più un massimo di 9 immagini di riferimento, in una delle sette proporzioni. Invia la richiesta, conserva l’ID attività restituito e leggi l’immagine finita dall’attività. Le immagini di riferimento vengono passate come URL.

ID modello

Consulta la pagina del modello per i prezzi attuali.

Esempio rapido

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"
  }'

Endpoint

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

La risposta è un’attività ({"id": "task_...", "status": "processing"}), non l’immagine finita. Interroga GET /v1/tasks/{task_id} per ottenere il risultato. Conserva le chiavi API nel codice lato server. I riferimenti vengono passati nella stessa richiesta tramite image_urls; /v1/images/edits non viene usato per questo modello.

Parametri

I campi non presenti in questo elenco vengono eliminati prima dell’inoltro della richiesta; non causano mai errori e non modificano mai l’output. Non ci sono impostazioni per risoluzione, seed, prompt negativo, maschera o formato di output. callback_url non è disponibile; interroga invece l’attività.

Immagini di riferimento

Passa fino a 9 immagini in image_urls e indica in prompt cosa conservare e cosa cambiare. Muse Image le usa come riferimenti per una nuova immagine; omettendo aspect_ratio, il risultato ne segue le proporzioni.

{
  "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"
}

Input multimediali

Ogni riferimento è un URL HTTP(S) pubblico. I data URI in base64 non sono accettati: carica il file nel tuo storage e passa il suo URL. Usa immagini PNG, JPEG o WebP; i file originali di tutti i riferimenti devono avere una dimensione totale di 11 MB o meno. Un insieme oltre tale limite fallisce dopo l’accettazione e non viene addebitato.

Fattori di costo

Consulta la sezione prezzi del modello per le tariffe attuali. Muse Image ha un unico prezzo per immagine:

cost = price per image × 1

Le richieste con solo testo o con riferimenti e tutte le proporzioni costano uguale. L’importo riservato quando l’attività viene accettata è l’importo addebitato. Consulta gli addebiti definitivi nella cronologia di utilizzo del tuo account. Le attività fallite non vengono addebitate.

Schema di output

L’invio restituisce l’attività:

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

Recuperare l’attività

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

Interroga ogni 10–20 secondi finché status non diventa completed o failed. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l’ID attività e riprendi il controllo. Non creare un’altra attività per verificare l’avanzamento.

Attività completata

{
  "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’immagine viene consegnata in WebP, il formato nativo del modello; non ci sono impostazioni per il formato di output. Il modello determina le dimensioni in pixel. Nei nostri test una richiesta con solo testo ha restituito 1600 × 1600, 16:9 ha restituito 2048 × 1152, 3:4 ha restituito 1344 × 1792 e 9:16 ha restituito 1152 × 2048, circa 50–180 secondi dopo l’invio.

Errori

Le richieste rifiutate prima della creazione di un’attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un’attività che fallisce dopo l’accettazione restituisce HTTP 200 quando viene interrogata, con status: "failed" e un oggetto error.

Vedi il catalogo errori comune per codici, stati HTTP e indicazioni sui tentativi.

{
  "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."
  }
}

Se l’invio stesso va in timeout, controlla le tue attività prima di inviare di nuovo: la prima richiesta potrebbe essere stata accettata.

Suggerimenti

• Indica soggetto, ambientazione, luce e inquadratura; Muse Image segue fedelmente un brief preciso.
• Con i riferimenti, specifica esattamente cosa deve restare invariato, come il colore o la forma del prodotto.
• Ometti aspect_ratio per seguire le proporzioni di un riferimento; impostalo per ritagliare in base al canale.
• Aggiungi no text, no logos per evitare marchi inventati.

Correlati

• Playground e prezzi di Muse Image
• Riferimento API di Muse Video
• Scarica l’OpenAPI
• Markdown copiabile