Meta
Muse Video 1.0
muse-video-1.0/image-to-video
Ein von Meta Superintelligence Labs vorgestelltes Videogenerierungsmodell, das Text-zu-Video und Bild-zu-Video unterstützt; jedes Video ist fest 10 Sekunden lang, 720p und enthält eigenen Ton; bei Bild-zu-Video können 1 bis 9 Referenzbilder die Szene lenken – ideal für die Visualisierung von Social-Media-Material und Storyboard-Konzepten
muse-video-1.0/image-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
muse-video-1.0/image-to-video per video
| Einzelpreis | $0.0336 |
|---|
Kurzbeschreibung
Dieses Modell nimmt Bilder und Text-Prompts entgegen und erzeugt ein Video mit fester Länge von 10 Sekunden in 720p mit integriertem Ton. Nutzer können 1 bis 9 Referenzbilder hochladen, um die Bildgestaltung zu steuern, und mit einem Prompt die Bewegung des Motivs sowie die Kamerabewegung beschreiben; das Seitenverhältnis kann automatisch an die Referenzbilder angepasst oder manuell festgelegt werden. Geeignet für Entwickler und Kreative, die statische Konzepte, Produktbilder oder Storyboard-Skizzen schnell in Videosequenzen umwandeln möchten.
Hauptmerkmale
- Bildführung durch mehrere Referenzen – Unterstützt die Übergabe von 1 bis 9 Referenzbildern auf einmal, die als visuelle Grundlage für Szene, Motiv oder Stil dienen.
- Automatisches oder manuelles Seitenverhältnis – Standardmäßig wird das Seitenverhältnis der Referenzbilder automatisch übernommen; alternativ kann das Ausgabeformat aus sieben gängigen Seitenverhältnissen gewählt werden.
- Bewegung und Kamera per Prompt beschreiben – Mit einem Prompt von bis zu 5000 Zeichen lässt sich festlegen, wie sich das Motiv bewegt, wie die Kamera fährt und welcher Ton gewünscht ist.
Funktionsumfang
Videogenerierung aus Bildreferenzen: Mit 1 bis 9 Referenzbildern und einem begleitenden Prompt wird eine Videosequenz mit Motiv- und Kamerabewegung erzeugt; die Referenzbilder dienen der Bildführung und stellen nicht zwangsläufig ein pixelgenaues erstes Frame dar.
Beschreibung von Bewegung und Kamera: Der Prompt umfasst bis zu 5000 Zeichen und dient der Beschreibung der Bewegungsart des Motivs in den Referenzbildern, der Kamerarichtung sowie der gewünschten Bildstimmung.
Steuerung des Seitenverhältnisses: aspect_ratio unterstützt auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3; bei auto folgt das Ausgabeverhältnis den Referenzbildern, alternativ kann das Format manuell festgelegt werden.
Anwendungsfälle
- Kreative verwandeln Konzeptbilder in dynamische Sequenzen – Konzeptbilder hochladen, Aktion und Kamera beschreiben und Bewegtmaterial erhalten, das direkt für Kurzfilme oder Social-Media-Inhalte genutzt werden kann.
- Produktbilder als Grundlage für Präsentationsvideos – Produktbilder als Referenz verwenden, eine umkreisende oder heranfahrende Kamerabewegung beschreiben und Videosequenzen für E-Commerce-Seiten oder Werbematerial erzeugen.
- Dynamische Vorschau von Storyboard-Skizzen – Storyboard-Skizzen als Referenzbilder verwenden, den Bewegungsrhythmus per Prompt ergänzen und schnell eine dynamische Vorschau für Pitch oder interne Reviews erhalten.
Einschränkungen und Auswahlhinweise
Für aspect_ratio kann jeweils nur ein Enum-Wert gewählt werden; mehrere Seitenverhältnisse gleichzeitig sind nicht möglich. Referenzbilder werden über URL übergeben und müssen über einen erreichbaren http- oder https-Link verfügbar sein, maximal 9 pro Anfrage. Referenzbilder wirken als Bildführung und stellen weder zwangsläufig ein pixelgenaues erstes Frame noch eine absolute Konsistenz von Figuren oder Szenen sicher. Die Dauer ist fest auf 10 Sekunden und die Auflösung fest auf 720p eingestellt und nicht anpassbar. Anfragen mit leerem Prompt oder einem Prompt, der nur Leerzeichen enthält, können nicht übermittelt werden.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell verfügbar: Muse Video 1.0 Bild-zu-Video
- Neues Modell Neues Modell verfügbar: Muse Video 1.0 Text-zu-Video
Häufige Fragen
Alle Fragen ansehen →-
Wie lang kann das Modell Videos generieren?
Jeder Clip ist fest auf 10 Sekunden festgelegt. Die Dauer lässt sich nicht anpassen; wenn im Prompt eine „längere Dauer“ angegeben wird, hat das keine Wirkung. Wenn längere Inhalte benötigt werden, generiert man sie in 10-Sekunden-Segmenten und setzt sie anschließend selbst zusammen.
-
Können Ausgabeauflösung und Seitenverhältnis geändert werden?
Die Auflösung ist fest auf 720p eingestellt und kann nicht angepasst werden. Das Seitenverhältnis wird über aspect_ratio angegeben: Bei der Bild-zu-Video-Generierung sind auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2 und 2:3 verfügbar, Standard ist auto (folgt dem Seitenverhältnis des Referenzbildes); bei der Text-zu-Video-Generierung sind die letztgenannten 7 Seitenverhältnisse verfügbar, Standard ist 16:9.
-
Wie viele Referenzbilder können maximal übergeben werden?
1 bis 9 Bilder, übergeben als http- oder https-Link. Referenzbilder dienen zur Steuerung des Bildinhalts, es wird jedoch nicht garantiert, dass sie als pixelgenau identisches erstes Frame übernommen werden; wenn ein bestimmtes Bild den Bildinhalt dominieren soll, weise im Prompt ausdrücklich darauf hin (z. B. „Die Person aus dem 1. Bild als Hauptmotiv“), die übrigen Bilder dienen nur als Ergänzung von Stil oder Elementen.
-
Wie muss der Prompt geschrieben werden, damit die Bewegung im Bild stimmt?
Schreibe in der Reihenfolge der vier Abschnitte „Entsprechung von Motiv und Referenzbild → Aktion des Motivs → Kamerabewegung → Ton“, mit je einem konkreten Satz pro Abschnitt. Schreibe zum Beispiel zuerst „Der rote Sportwagen aus dem 1. Bild steht im Mittelpunkt“, dann „Die Räder drehen sich, die Karosserie bewegt sich langsam vorwärts“, danach „Die Kamera folgt aus niedriger Seitenperspektive“ und schließlich „Das leise Brummen des Motors und das Reifenquietschen“. Die Kamerabewegung steht in einem eigenen Satz und darf nicht mit der Aktion des Motivs in einem Satz vermischt werden.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: muse-video-1.0/image-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für muse-video-1.0/image-to-video und Route default — siehe Parametertabelle unten.
promptstringPflichtminLength 1maxLength 5000pattern \SBeschreibe, wie sich das Motiv im Referenzbild bewegt, wie sich die Kamera bewegt und welcher Toneffekt gewünscht ist. Das generierte Video ist fest auf 10 Sekunden und 720p festgelegt und enthält von sich aus Ton.
image_urlsarrayPflichtminItems 1maxItems 9Ein Array von Referenzbild-URLs zur Steuerung der Videogenerierung, unterstützt 1–9 Bilder über http oder https; diese Bilder werden nicht garantiert zu einem pixelgenau exakten ersten Frame.
Array [ string ]
aspect_ratiostringOptionalStandard: "auto"Steuert das Seitenverhältnis des Ausgabevideos: auto bedeutet, dem Verhältnis des Referenzbilds zu folgen, alternativ kann ein festes Seitenverhältnis angegeben werden. Standard ist auto.
auto16:99:161:14:33:43:22:3callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
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"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"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 Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"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"
}
}
} Artikel
Alle Artikel ansehen →Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Veo 3.1 Google $0.290 /Sekunde -
HeyGen Avatar V HeyGen $0.150 /Sekunde -
Grok Imagine 1.5 xAI $0.011 /Sekunde -
PixVerse V6 PixVerse $0.036 /Sekunde -
Veo 3.1 Fast Google $0.170 /Sekunde -
Wan 2.6 Flash Alibaba $0.043 /Sekunde -
Seedance 2.5 ByteDance $0.121 /Sekunde -
Kling 3.0 Kuaishou $0.100 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
Kling 2.5 Kuaishou $0.090 /Sekunde -
HappyHorse 1.0 Alibaba $0.168 /Sekunde -
Kling 4.0 Kuaishou $0.204 /Sekunde

