Breng uw afbeeldingen tot leven door een hoogwaardige video-animatie te genereren.

Afbeelding naar Video

Het Afbeelding naar Video-eindpunt brengt statische afbeeldingen tot leven door een hoogwaardige video-animatie te genereren op basis van een tekstprompt.

Modelnaam: image-to-video

Levenscyclus: experimenteel

Verwerkingstijd: ~60s–180s

Uitvoerformaat: MP4

Leveringsmethoden: URL (via status polling)

Credits: 6 tot 12 per video (afhankelijk van duur)

Verzoek

Genereer een video door uw afbeelding en prompt in te dienen bij het universele /v1/run-eindpunt:

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

Voorbeelden van verzoeken

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"
           }
         }'

Antwoord

Omdat het genereren van video's enkele minuten duurt, retourneert het /v1/run-eindpunt onmiddellijk een 200 OK-status met een asynchrone job id. U moet de Status API pollen met GET /v1/status/{id} om de uiteindelijke MP4-URL op te halen. Als alternatief kunt u webhooks configureren om automatisch meldingen te ontvangen. Houd er rekening mee dat onze webhook-dispatcher een strikte time-out van 15 seconden hanteert. Uw server moet de webhook binnen 15 seconden bevestigen met een 2xx-statuscode, anders beschouwen wij het als mislukt en proberen we het later opnieuw.

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

Verzoekparameters

Vereiste parameters

imageUrlRequiredstring

De in te voeren afbeelding om te animeren. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks.

Pro Tip: Afbeeldingen met zichtbaar haar, stof of gebladerte produceren de meest natuurlijk ogende beweging. Statische flat-lay of product-only foto's animeren niet goed — gebruik afbeeldingen met een persoon of scène. Vermijd zwaar bijgesneden afbeeldingen om de AI ruimte te geven voor beweging.

Opmaakvereiste Bij het indienen van een Base64-reeks moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...).

Optionele parameters

promptstring

Een tekstuele beschrijving die de animatie stuurt. Indien weggelaten, zal de AI natuurlijke beweging afleiden uit de afbeeldingscontext.

durationinteger

De lengte van de gegenereerde video in seconden. Ondersteunde waarden: 4, 6, 8. Standaard: 6

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

De beeldverhouding van de uitvoervideo. Standaard: 9:16

generateAudioboolean

Of er contextuele AI-audio moet worden gegenereerd om de video te begeleiden. Standaard: true

Runtimefouten

Runtimefouten voor deze functie maken gebruik van de gedeelde set die is gedocumenterd in Foutafhandeling. Als er een fout optreedt tijdens de verwerking, wordt de status bijgewerkt naar "error" en bevat het error-veld de specifieke reden van de storing.

Creditkosten

Voor Developer API-verzoeken zijn de kosten volledig afhankelijk van de aangevraagde video duration.

Formule: Kosten = DuurCredits

Duur	Credits per Video
4s	6
6s (Standaard)	9
8s	12