Documentation API

API Viffly

Intégrez la génération de Reels dans vos workflows automatisés. L'API REST Viffly permet de créer des vidéos, suivre les rendus et accéder à l'historique depuis n'importe quelle application.

⚠️

L'accès API est disponible uniquement avec le plan Business.

Voir les tarifs →

Authentification

Toutes les requêtes API doivent inclure votre token JWT dans le header Authorization. Récupérez votre token en vous connectant sur Viffly et depuis votre profil.

bash

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

POST/api/generateGénération

Lance la génération d'un Reel vidéo. Accepte audio, images, paramètres de style et de langue. Retourne un job_id pour suivre la progression.

Paramètres

audio

File | URL

requis

Fichier audio (mp3/wav) ou URL publique

image_url_0..4

URL

requis

URL(s) des images (min. 1, max. 5)

language

string

optionnel

Code langue : fr, ar, en, es, de, pt (défaut: auto)

template

string

optionnel

default | news | minimal | highlight

title

string

optionnel

Titre affiché dans l'intro

outro_text

string

optionnel

Texte principal de l'outro

outro_sub

string

optionnel

Sous-texte de l'outro

music_url

URL

optionnel

URL d'un fichier audio pour la musique de fond

Exemple

curl

curl -X POST https://viffly.app/api/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "audio=@narration.mp3" \
  -F "image_url_0=https://example.com/img1.jpg" \
  -F "template=default" \
  -F "language=fr"