Erwecken Sie Ihre Bilder zum Leben, indem Sie eine hochwertige Videoanimation generieren.

Bild zu Video

Der Bild-zu-Video-Endpunkt erweckt statische Bilder zum Leben, indem er eine hochwertige Videoanimation basierend auf einer Textaufforderung generiert.

Modellname: image-to-video

Lebenszyklus: experimental

Verarbeitungszeit: ~60s–180s

Ausgabeformat: MP4

Liefermethoden: URL (mittels Statusabfrage)

Credits: 6 bis 12 pro Video (abhängig von der Dauer)

Anfrage

Generieren Sie ein Video, indem Sie Ihr Bild und Ihre Aufforderung an den universellen /v1/run-Endpunkt senden:

POSThttps://fititon.app/api/v1/run

Anfragebeispiele

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

Antwort

Da die Videogenerierung mehrere Minuten dauert, gibt der /v1/run-Endpunkt sofort einen 200 OK-Status mit einer asynchronen Job-id zurück. Sie müssen die Status-API mittels GET /v1/status/{id} abfragen, um die endgültige MP4-URL abzurufen. Alternativ können Sie Webhooks konfigurieren, um Benachrichtigungen automatisch zu erhalten. Bitte beachten Sie, dass unser Webhook-Dispatcher ein striktes 15-Sekunden-Timeout durchsetzt. Ihr Server muss den Webhook innerhalb von 15 Sekunden mit einem 2xx-Statuscode bestätigen, andernfalls betrachten wir ihn als fehlgeschlagen und versuchen es später erneut.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Anfrageparameter

Erforderliche Parameter

imageUrlRequiredstring

Das Eingabebild zur Animation. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein.

Profi-Tipp: Bilder mit sichtbaren Haaren, Stoffen oder Laub erzeugen die natürlichste Bewegung. Statische Flat-Lay- oder reine Produktfotos lassen sich nicht gut animieren – verwenden Sie Bilder mit einer Person oder Szene. Vermeiden Sie stark zugeschnittene Bilder, um der KI Raum für Bewegung zu geben.

Formatierungsanforderung Beim Übermitteln eines Base64-Strings muss dieser das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,...).

Optionale Parameter

promptstring

Eine textuelle Beschreibung, die die Animation leitet. Wenn weggelassen, leitet die KI natürliche Bewegung aus dem Bildkontext ab.

durationinteger

Die Länge des generierten Videos in Sekunden. Unterstützte Werte: 4, 6, 8. Standard: 6

aspectRatio'16:9' | '9:16'

Das Seitenverhältnis des Ausgabevideos. Standard: 9:16

generateAudioboolean

Ob kontextbezogenes KI-Audio zur Begleitung des Videos generiert werden soll. Standard: true

Laufzeitfehler

Laufzeitfehler für diese Funktion verwenden den gemeinsamen Satz, der unter Fehlerbehandlung dokumentiert ist. Tritt während der Verarbeitung ein Fehler auf, wird der status auf "error" aktualisiert und das error-Feld enthält den spezifischen Fehlergrund.

Kosten für Credits

Für Developer API-Anfragen hängen die Kosten vollständig von der angeforderten Video-duration ab.

Formel: Kosten = DauerCredits

Dauer	Credits pro Video
4s	6
6s (Standard)	9
8s	12