Meta
Muse Video 1.0
muse-video-1.0/text-to-video
Modello di generazione video lanciato da Meta Superintelligence Labs, supporta la generazione video da testo e da immagine, ogni video è fisso a 10 secondi, 720p, con audio integrato; la generazione da immagine può utilizzare da 1 a 9 immagini di riferimento per guidare la scena, adatto alla visualizzazione di contenuti per social media e concept di storyboard
Prova muse-video-1.0/text-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
muse-video-1.0/text-to-video per video
| Prezzo unitario | $0.0336 |
|---|
Panoramica
Si tratta di un modello di generazione video da testo: basta inserire un prompt per generare un video, ciascuno della durata fissa di 10 secondi, a 720p e con audio integrato. È possibile specificare le proporzioni dell'immagine, con impostazione predefinita 16:9, oppure scegliere 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, adattandosi a diverse scene di visualizzazione come orizzontale, verticale e quadrata. Il prompt può contenere fino a 5000 caratteri e serve a descrivere soggetto, azione, movimento della camera e audio desiderato. È pensato per creatori di contenuti, social media manager e designer di concept video, ed è adatto a trasformare rapidamente idee testuali in risorse video utilizzabili come storyboard, clip atmosferiche o materiale per video brevi.
Punti di forza principali
- Proporzioni flessibili——Offre sette formati immagine, con impostazione predefinita 16:9, coprendo esigenze comuni come orizzontale, verticale, quadrato, 4:3 e 3:2.
- Prompt per descrivere il movimento della camera——Il testo inserito può includere informazioni su soggetto, azione e movimento della camera, facilitando l'organizzazione della narrazione visiva e della regia in un'unica generazione.
- Durata fissa di 10 secondi con audio integrato——Ogni chiamata restituisce un video di 10 secondi a 720p, con immagini e audio generati insieme, senza necessità di aggiungere tracce audio separatamente.
Descrizione delle capacità
Generazione video da testo: fornendo un prompt si genera il video corrispondente; il prompt può contenere fino a 5000 caratteri e può descrivere soggetto, azione, movimento della camera e audio; l'output è fisso a 10 secondi, 720p e include audio.
Controllo delle proporzioni: specificare le proporzioni dell'immagine tramite il parametro aspect_ratio, scegliendo tra 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, con impostazione predefinita 16:9, per adattare il formato alla posizione di pubblicazione.
Casi d'uso
- Materiale video verticale per social media——Gli operatori descrivono con un prompt soggetto e regia, specificano il rapporto 9:16 e generano una clip video verticale da usare per la pubblicazione o il montaggio su piattaforme di video brevi.
- Visualizzazione di concept video e storyboard——Registi o storyboard artist descrivono con un testo il movimento della camera e generano la clip video corrispondente, come anteprima dello storyboard o riferimento visivo per la comunicazione del concept.
- Anteprima di contenuti orizzontali——I creatori generano clip video con il rapporto predefinito 16:9 per anteprime creative di scene orizzontali o come test visivo prima del montaggio finale.
- Realizzazione di video segnaposto quadrati——I designer generano video con rapporto 1:1 o 4:3 da inserire in feed o spazi pubblicitari quadrati, ottenendo rapidamente materiale dinamico adatto al formato.
Limiti e consigli per la scelta
Attualmente è disponibile solo la generazione da testo a video; non è supportato l'input di immagini. La durata è fissa a 10 secondi e la risoluzione fissa a 720p, non modificabili. Il prompt può contenere fino a 5000 caratteri; oltre tale limite non è possibile inviarlo. Le proporzioni dell'immagine possono essere selezionate una sola volta per richiesta e solo tra quelle elencate. Il video generato è guidato esclusivamente dal prompt testuale, senza controllo tramite primo frame, ultimo frame o immagini di riferimento. I movimenti rapidi e la fisica potrebbero non essere accurati.
Novità
Vedi il changelog →- Nuovo modello Nuovo modello disponibile: Muse Video 1.0 image-to-video
- Nuovo modello Nuovo modello disponibile: Muse Video 1.0 per la generazione di video da testo
Domande frequenti
Vedi tutte le domande →-
Quanto può essere lungo il video generato da questo modello?
Ogni clip dura esattamente 10 secondi. La durata non è regolabile: scrivere "più a lungo" nel prompt non ha alcun effetto; se serve un contenuto più lungo, generare segmenti da 10 secondi e montarli insieme.
-
È possibile modificare la risoluzione di output e il formato?
La risoluzione è fissa a 720p e non è modificabile. Il formato si specifica con aspect_ratio: per la generazione di video da immagine sono disponibili auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, con valore predefinito auto (che segue le proporzioni dell'immagine di riferimento); per la generazione di video da testo sono disponibili gli ultimi 7 formati, con valore predefinito 16:9.
-
Quante immagini di riferimento si possono caricare al massimo?
Da 1 a 9 immagini, da passare tramite link http o https. Le immagini di riferimento servono a guidare la scena e non è garantito che diventino un primo fotogramma identico pixel per pixel; se vuoi che una determinata immagine domini la scena, indicala esplicitamente nel prompt (ad esempio "usa come soggetto principale la persona nella prima immagine"), mentre le altre immagini fungono solo da integrazione di stile o di elementi.
-
Come si deve scrivere il prompt per far muovere correttamente l'immagine?
Scrivi nell'ordine di quattro sezioni: «relazione tra soggetto e immagine di riferimento → azione del soggetto → movimento di camera → suono», con una descrizione specifica per ogni sezione. Ad esempio, scrivi prima «con l'auto sportiva rossa della prima immagine come soggetto», poi «le ruote girano e la carrozzeria avanza lentamente», quindi «la camera segue dal lato con un'inquadratura dal basso», e infine «il rombo sordo del motore e il rumore dell'attrito degli pneumatici». Il movimento di camera va in una frase separata, non va mescolato con l'azione del soggetto nella stessa frase.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl 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-KeystringOpzionaleChiave 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.
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
modelstringObbligatorioValore fisso attuale: muse-video-1.0/text-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per muse-video-1.0/text-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 5000pattern \SPrompt testuale: descrivi in linguaggio naturale il soggetto, l'azione, il movimento di camera e il suono. I video generati sono tutti di 10 secondi, 720p e includono l'audio.
aspect_ratiostringOpzionalePredefinito: "16:9"Specifica le proporzioni del video generato come stringa; il valore predefinito è 16:9.
16:99:161:14:33:43:22:3callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
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.
urlstringObbligatorioObbligatoria 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.
finalstoragestringOpzionalePredefinito: "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.
temppersistentEsempi 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-video-1.0/text-to-video",
"input": {
"prompt": "…",
"aspect_ratio": "16:9"
}
}' 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-video-1.0/text-to-video",
input: {
"prompt": "…",
"aspect_ratio": "16:9"
}
}),
});
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-video-1.0/text-to-video",
"input": {
"prompt": "…",
"aspect_ratio": "16:9"
}
},
)
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à
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome 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.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
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.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi 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
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione 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"
}
}
} Articoli
Vedi tutti gli articoli →Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
OmniHuman 2.0 ByteDance $0.100 /secondo -
Vidu Q4 Preview Vidu $0.051 /secondo -
MiniMax H3 MiniMax $0.072 /secondo -
Kandinsky 6.0 Pro $1.93 /video -
FLUX 3 Max Black Forest Labs $0.121 /secondo -
P-Video 2 Pro Avatar Pruna AI $0.029 /secondo -
P-Video 2 Pro Replace Pruna AI $0.036 /secondo -
Kling 3.0 Kuaishou $0.100 /secondo -
Wan 3.0 Video Alibaba $0.040 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo -
Gemini Omni 1.1 Google $0.450 /video -
Veo 3.1 Fast Google $0.170 /secondo