21:9 高调光晕宽幅：左侧留白，右侧悬浮半透明玻璃渲染面板与光带轨道，冷蓝、珊瑚粉与暖金渐变，模型名以玻璃蚀刻发光立体字呈现。

Muse Image 1.0

muse-image-1.0/text-to-image

Modello di generazione e modifica di immagini con ragionamento di Meta: scompone prima i prompt complessi e poi esegue il rendering, può integrare più immagini di riferimento e si avvale della ricerca web per garantire l'accuratezza fattuale

muse-image-1.0/image-to-image muse-image-1.0/text-to-image

Prova muse-image-1.0/text-to-image

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

muse-image-1.0/text-to-image per task

Prezzo unitario	$0.015

Panoramica della posizione

muse-image-1.0/text-to-image è la linea puramente testuale su HiAPI.ai del modello text-to-image lanciato da Meta, che adotta un flusso di generazione basato su prima ragionamento e poi rendering: prima di generare l'immagine scompone i prompt multi-segmento, pianifica il layout dell'immagine e si autocorregge durante il ragionamento. È adatto a sviluppatori che necessitano di generazione batch ad alta concorrenza con prompt piuttosto complessi, ad esempio varianti di materiali pubblicitari, immagini di cataloghi prodotti e simili. Tramite l'interfaccia unificata di HiAPI.ai basta un prompt testuale per generare immagini, con rapporto d'aspetto e formato di output selezionabili.

Punti di forza principali

Prima ragionamento poi rendering, prompt complessi più controllabili——prima del rendering scompone i prompt multi-segmento nella catena di ragionamento, pianifica il layout e corregge iterativamente l'output, risultando più adatto alla generazione strutturata rispetto a una singola generazione forward.
I prompt ad alta intensità di conoscenza possono avvalersi della ricerca web——quando si incontrano prompt che richiedono informazioni del mondo reale viene attivata la ricerca web per calibrare i contenuti, riducendo le deviazioni nelle illustrazioni di tipo fattuale.
Output di un'immagine finita con una singola chiamata, integrazione semplice——è sufficiente inviare un prompt testuale per specificare il rapporto d'aspetto e il formato di output jpeg, png o webp, ottenendo direttamente asset immagine pronti all'uso.

Descrizione delle capacità

Text-to-image con ragionamento: scompone prompt complessi multi-segmento in elementi visivi eseguibili, pianifica il layout prima del rendering e si autocorregge, riducendo i costi della modifica ripetuta dei prompt.

Rapporti d'aspetto preimpostati: offre nove rapporti 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21, selezionabili direttamente in base al posizionamento o al layout, senza necessità di ritaglio successivo.

Output multi-formato: supporta tre formati di download jpeg, png, webp, predefinito webp, per scegliere facilmente in base alla visualizzazione frontend, all'archiviazione o ai processi di elaborazione successivi.

Supporto a prompt lunghi: il limite del prompt è di 5000 caratteri, sufficiente per esigenze di generazione complesse con più paragrafi e descrizioni vincolate.

Scenari applicabili

Generazione batch di varianti pubblicitarie da parte dei team di campagne——generare immagini in batch con più gruppi di prompt testuali sullo stesso punto di vendita, producendo materiali con rapporti diversi, direttamente utilizzabili per test di advertising multicanale.
Realizzazione di immagini di scenario prodotto da parte degli operatori e-commerce——generare immagini di scenario con stili e composizioni diversi a partire da testi descrittivi del prodotto, integrando le immagini dei cataloghi prodotti e delle pagine di dettaglio.
Illustrazioni per argomenti divulgativi da parte dei content manager——inserendo descrizioni di argomenti con elementi fattuali, produrre illustrazioni aderenti ai contenuti, per articoli, post e pubblicazioni sui social media.

Limiti e consigli per la scelta

I materiali pubblici non rivelano la risoluzione di output di questa linea; il rapporto d'aspetto determina solo le proporzioni, non le dimensioni precise in pixel, quindi gli scenari con requisiti rigidi di risoluzione devono essere verificati in anticipo. Il flusso basato su ragionamento e la ricerca web su richiesta comportano latenze aggiuntive, quindi non è adatto a generazioni in tempo reale con latenza estremamente bassa. L'output è limitato alle immagini e non riguarda video o audio. Se l'attività richiede fusione o riscrittura basate su immagini di riferimento, è necessario scegliere la linea image-to-image della stessa famiglia.

Domande frequenti

Vedi tutte le domande →

Come scegliere tra generazione di immagini da testo e modifica di immagini?

Scegli la generazione di immagini da testo quando hai solo testo e parti da zero; scegli la modifica di immagini e fornisci un'immagine di riferimento quando devi mantenere un soggetto o un layout esistente.
Quante immagini si possono ottenere ogni volta?

Ogni attività restituisce un'immagine, non è possibile scegliere il numero di immagini. Per confrontare un'altra composizione, modifica il prompt e invia una nuova attività.
È possibile scegliere 1K, 2K o 4K?

Questa voce non offre livelli di risoluzione. Il formato è a tua scelta, mentre le dimensioni in pixel sono determinate dal modello, di solito circa 2,5 MP; fai riferimento alle dimensioni effettive del file scaricato.
Quali formati di file posso scegliere?

Puoi scegliere JPEG, PNG o WebP; se non ne selezioni uno, viene utilizzato WebP. Scegli in base alle esigenze delle successive risorse web o degli strumenti di progettazione.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: muse-image-1.0/text-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per muse-image-1.0/text-to-image e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1maxLength 5000

Serve a descrivere l'immagine che si desidera generare, oppure a indicare i contenuti dell'immagine di riferimento da modificare e quelli da mantenere, in forma di stringa.

aspect_ratiostringOpzionale

Seleziona le proporzioni dell'immagine di output, in forma di stringa; questa opzione non specifica dimensioni esatte in pixel.

Opzioni:1:14:33:416:99:163:22:321:9

Mostra tutto (1)

9:21

output_formatstringOpzionalePredefinito: "webp"

Seleziona il formato file dell'immagine da scaricare, in forma di stringa, predefinito webp.

Opzioni:jpegpngwebp

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "muse-image-1.0/text-to-image",
  "input": {
    "prompt": "…",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "muse-image-1.0/text-to-image",
    input: {
      "prompt": "…",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "muse-image-1.0/text-to-image",
        "input": {
          "prompt": "…",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}