API Documentation

APIViffly

Integrate Reels generation into your automated workflows. The Viffly REST API lets you create videos, track renders, and access history from any application.

⚠️

API access is available only with theBusinessplan.

See pricing →

Authentication

All API requests must include your JWT token in theAuthorizationheader. Retrieve your token by logging in to Viffly from your profile.

bash

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

POST/api/generateGeneration

Starts generating a video Reel. Accepts audio, images, style and language parameters. Returns a job_id to track progress.

Parameters

audio

File | URL

required

Audio file (mp3/wav) or public URL

image_url_0..4

URL

required

Image URL(s) (min. 1, max. 5)

language

string

optional

Language code: fr, ar, en, es, de, pt (default: auto)

template

string

optional

default | news | minimal | highlight

title

string

optional

Title displayed in the intro

outro_text

string

optional

Main text of the outro

outro_sub

string

optional

Subtext of the outro

music_url

URL

optional

URL of an audio file for the background music

Example

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"