Meta
Muse Video 1.0
muse-video-1.0/image-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/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
muse-video-1.0/image-to-video per video
| Prezzo unitario | $0.0336 |
|---|
Panoramica e posizionamento
Il modello riceve immagini e prompt testuali e restituisce un video di durata fissa pari a 10 secondi, in 720p, con audio integrato. L'utente può caricare da 1 a 9 immagini di riferimento per guidare le scene e usare il prompt per descrivere il movimento del soggetto e quello della camera; supporta l'adeguamento automatico al rapporto d'aspetto delle immagini di riferimento oppure la specifica manuale del formato. È adatto a sviluppatori e creatori che desiderano convertire rapidamente concetti statici, immagini di prodotto o bozze di storyboard in clip video.
Punti di forza principali
- Guida delle scene tramite più immagini di riferimento — consente di fornire da 1 a 9 immagini di riferimento in una sola richiesta per dare una base visiva a scena, soggetto o stile.
- Formato automatico o manuale — per impostazione predefinita segue automaticamente il rapporto d'aspetto delle immagini di riferimento, ma è anche possibile scegliere il formato di output tra sette rapporti comuni.
- Descrizione del movimento e della camera tramite prompt — con un prompt fino a 5000 caratteri si specifica come si muove il soggetto, come si muove la camera e l'audio desiderato.
Descrizione delle capacità
Generazione video da immagini di riferimento: fornendo da 1 a 9 immagini di riferimento insieme a un prompt si genera una clip con movimento del soggetto e movimento della camera; le immagini servono a guidare le scene e non è garantito che diventino un primo fotogramma identico pixel per pixel.
Descrizione di movimento e camera: il prompt, fino a 5000 caratteri, descrive il modo in cui si muove il soggetto nelle immagini di riferimento, la direzione del movimento della camera e l'atmosfera visiva desiderata.
Controllo del rapporto d'aspetto: aspect_ratio può essere auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3; con auto il rapporto di output segue le immagini di riferimento, oppure è possibile specificare manualmente il formato.
Casi d'uso
- Trasformare immagini concettuali in clip dinamiche da parte dei creatori — caricando un'immagine di concept e descrivendo azioni e camera si ottiene materiale dinamico utilizzabile direttamente in cortometraggi o contenuti social.
- Generare video dimostrativi da immagini di prodotto — usando un'immagine di prodotto come riferimento e descrivendo una camera orbitale o un movimento di zoom, si genera una clip video per pagine e-commerce o materiali promozionali.
- Anteprima dinamica di bozze di storyboard — usando una bozza di storyboard come immagine di riferimento e completando il ritmo di movimento con il prompt, si ottiene rapidamente un'anteprima dinamica per proposte o revisioni interne.
Limiti e consigli di scelta
aspect_ratio accetta un solo valore enum per volta e non può restituire più formati contemporaneamente. Le immagini di riferimento vengono passate tramite URL e richiedono link http o https accessibili, con un massimo di 9 immagini per richiesta. Le immagini di riferimento guidano le scene, ma non è garantito che diventino un primo fotogramma identico pixel per pixel né che personaggi o scene siano assolutamente coerenti. La durata è fissa a 10 secondi e la risoluzione fissa a 720p, non modificabili. Le richieste con prompt vuoto o contenente solo spazi non possono essere inviate.
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/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per muse-video-1.0/image-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 5000pattern \SDescrivi come si muove il soggetto nell'immagine di riferimento, come si muove la telecamera e gli effetti sonori desiderati. Il video generato è fisso a 10 secondi, 720p e include l'audio.
image_urlsarrayObbligatoriominItems 1maxItems 9Array di URL di immagini di riferimento per guidare la generazione del video, supporta da 1 a 9 immagini http o https; queste immagini non sono garantite come primo fotogramma pixel-perfect.
Array [ string ]
aspect_ratiostringOpzionalePredefinito: "auto"Controlla le proporzioni del video in output: auto indica di seguire le proporzioni dell'immagine di riferimento, oppure è possibile specificare un rapporto d'aspetto fisso. Predefinito auto.
auto16: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/image-to-video",
"input": {
"prompt": "…",
"image_urls": "…",
"aspect_ratio": "auto"
}
}' 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/image-to-video",
input: {
"prompt": "…",
"image_urls": "…",
"aspect_ratio": "auto"
}
}),
});
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/image-to-video",
"input": {
"prompt": "…",
"image_urls": "…",
"aspect_ratio": "auto"
}
},
)
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
-
HappyHorse 1.0 Alibaba $0.168 /secondo -
PixVerse V6 Max PixVerse $0.030 /secondo -
Vidu Q3 Vidu $0.149 /secondo -
Veo 3.1 Fast Google $0.170 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo -
FLUX 3 Video Black Forest Labs $0.090 /secondo -
Creatify Boreal Creatify $0.015 /secondo -
Runway Gen 4.5 Runway $0.172 /secondo -
MiniMax H3 MiniMax $0.072 /secondo -
Seedance 2.5 ByteDance $0.121 /secondo -
Vidu Q4 Preview Vidu $0.051 /secondo -
HappyHorse 1.1 Alibaba $0.160 /secondo

