Image vers Vidéo

Le point de terminaison Image vers Vidéo donne vie aux images statiques en générant une animation vidéo de haute qualité basée sur une invite textuelle.

Nom du modèle : image-to-video

Cycle de vie : expérimental

Temps de traitement : ~60s–180s

Format de sortie : MP4

Méthodes de livraison : URL (via interrogation de statut)

Crédits : 6 à 12 par vidéo (dépend de la durée)

Requête

Générez une vidéo en soumettant votre image et votre invite au point de terminaison universel /v1/run :

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

Exemples de requêtes

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

Réponse

Étant donné que la génération de vidéo prend plusieurs minutes, le point de terminaison /v1/run renvoie immédiatement un statut 200 OK avec un id de tâche asynchrone. Vous devez interroger l'API de statut en utilisant GET /v1/status/{id} pour récupérer l'URL MP4 finale. Alternativement, vous pouvez configurer des webhooks pour recevoir des notifications automatiquement. Veuillez noter que notre répartiteur de webhooks applique un délai d'attente strict de 15 secondes. Votre serveur doit accuser réception du webhook avec un code de statut 2xx dans les 15 secondes, sinon nous le considérerons comme échoué et le retenterons plus tard.

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

Paramètres de la requête

Paramètres obligatoires

imageUrlRequiredstring

L'image d'entrée à animer. Peut être une URL accessible publiquement ou une chaîne d'image encodée en Base64.

Conseil de pro : Les images avec des cheveux, des tissus ou du feuillage visibles produisent le mouvement le plus naturel. Les photos statiques à plat ou de produits seuls ne s'animent pas bien — utilisez des images avec une personne ou une scène. Évitez les images fortement recadrées pour donner à l'IA de l'espace pour le mouvement.

Exigence de formatage Lors de la soumission d'une chaîne Base64, elle doit inclure le préfixe URI de données standard (par exemple, data:image/jpeg;base64,...).

Paramètres facultatifs

promptstring

Une description textuelle guidant l'animation. Si omise, l'IA inférera un mouvement naturel à partir du contexte de l'image.

durationinteger

La durée de la vidéo générée en secondes. Valeurs prises en charge : 4, 6, 8. Par défaut : 6

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

Le rapport d'aspect de la vidéo de sortie. Par défaut : 9:16

generateAudioboolean

Indique si l'audio IA contextuel doit être généré pour accompagner la vidéo. Par défaut : true

Erreurs d'exécution

Les erreurs d'exécution pour cette fonctionnalité utilisent l'ensemble partagé documenté dans Gestion des erreurs. Si une erreur survient pendant le traitement, le status passera à "error" et le champ error contiendra la raison spécifique de l'échec.

Coût en crédits

Pour les requêtes API Développeur, le coût dépend entièrement de la duration vidéo demandée.

Formule : Coût = CréditsDurée

Durée	Crédits par vidéo
4s	6
6s (Par défaut)	9
8s	12