API RapidVideoMaker

L'API REST vous permet de traiter des fichiers vidéo depuis n'importe quel client HTTP — scripts Python, workflows n8n, outils tiers. Cinq modes disponibles : Fusionner des vidéos (plusieurs MP4), Modifier l'audio (1 MP4 + 1 MP3), Créer une vidéo (1 JPG/PNG + 1 MP3), Superposition vidéo (2 MP4 picture-in-picture). Le traitement est asynchrone : soumettez les fichiers, puis interrogez le résultat.

Obtenez votre token API gratuitement

Créez un compte pour obtenir votre token API — 10 requêtes incluses par jour, utilisables depuis l'interface ou l'API.

Créer un compte gratuit Déjà un compte ? Se connecter

Workflow complet

Toute intégration suit le même enchaînement en 4 étapes :

Créer le job — POST /api/v1/render.php

Envoyez vos fichiers en multipart/form-data avec votre token Bearer. 1 image JPG/PNG + 1 MP3 + mode=image_to_video → génération vidéo. 1 MP4 + 1 MP3 → modification audio (ajoutez mode=mix_audio pour superposer les pistes). Plusieurs MP4 → fusion. Le serveur retourne un job_id unique.

Attendre la fin du job — GET /api/v1/jobs.php?job_id=…

Interrogez cet endpoint régulièrement (toutes les 5–10 s). Le job passe par les statuts queued → processing → ready (ou error). La réponse inclut la position dans la file et une estimation du temps restant.

Récupérer l'URL de téléchargement

Quand le statut est ready, la réponse contient un champ download_url prêt à l'emploi.

Télécharger le fichier — GET /api/download.php?job_id=…

Téléchargez le MP4 final. Le fichier est disponible pendant 2 heures après la fin du job, puis supprimé automatiquement. Après expiration, l'API répond 410 Gone (au lieu de 404) pour indiquer que le job a bien existé mais n'est plus récupérable.

Authentification

Chaque requête doit inclure votre token API. Deux formats sont acceptés :

# Authentification — Chaque requête doit inclure votre token API. Deux formats sont acceptés :
Authorization: Bearer rvm_your_token_here

# Alternative
X-API-Key: rvm_your_token_here

Votre token est disponible dans votre espace membre — un seul token par compte, créé automatiquement à l'inscription. Il n'est affiché en clair qu'une seule fois, conservez-le. Si vous le perdez, vous pouvez le régénérer depuis votre espace membre.

Quota

Chaque compte membre dispose de 10 requêtes par jour, partagées entre l'interface web et l'API. Les jobs en erreur ne consomment pas de quota. Le compteur se remet à zéro à minuit UTC.

Les réponses du POST incluent quota_used et quota_remaining. En cas de dépassement, le serveur répond 429.

Interface + API = même compteur. Une vidéo créée depuis l'interface web et une requête API consomment chacune 1 crédit dans le même quota journalier.

File d'attente

Un seul job est traité à la fois. Si plusieurs jobs sont soumis simultanément, ils sont mis en file d'attente et traités dans l'ordre d'arrivée. Pendant l'attente, la réponse de statut inclut :

queue_position — position du job dans la file (1 = prochain à être traité)
queue_total — nombre total de jobs en attente
eta_minutes — estimation du temps avant début de traitement

Limite appliquée : l'endpoint /api/v1/jobs.php accepte au maximum 12 appels par minute par token (1 toutes les 5 s). Au-delà, le serveur répond 429 avec un header Retry-After: 5. Recommandation : 10 secondes entre chaque appel.

Transitions disponibles

Passez transition_type=none (défaut) pour une fusion directe, ou l'un des types ci-dessous pour un fondu entre les clips :

none fade fadeblack dissolve wipeleft wiperight slideleft slideright zoomin circleclose

La durée (transition_duration) est comprise entre 0.2 et 2.0 secondes. Si un clip est trop court pour accueillir la transition, elle est ignorée et la fusion se fait sans transition.

Endpoints

Cinq modes, accessibles via le champ mode (omettez mode avec plusieurs MP4 pour détecter automatiquement fusion) :

Usage	Mode(s) API	Fichiers requis	Description
Fusionner des vidéos	`fusion`	2–20 fichiers MP4	Les clips sont assemblés bout à bout dans l'ordre fourni. Transitions optionnelles entre les clips.
Modifier l'audio	`add_audio` ou `mix_audio`	1 MP4 + 1 MP3	Remplace ou enrichit la piste audio d'une vidéo. La piste vidéo n'est jamais réencodée (`-c:v copy`). `add_audio` — l'audio d'origine est supprimé et entièrement remplacé par le MP3. `mix_audio` — l'audio d'origine est conservé et le MP3 est superposé (amix). Passez `options={"mp3_volume":…}` pour ajuster le volume du MP3 ajouté. Si la vidéo n'a pas d'audio, se comporte comme `add_audio`.
Créer une vidéo	`image_to_video`	1 image JPG/PNG + 1 MP3	Génère une vidéo à partir d'une image fixe et d'un fichier audio. Texte en overlay, fades, résolution et fps configurables via le champ `options`.
Superposition vidéo	`overlay_video`	2 MP4	Superpose une seconde vidéo sur la vidéo principale. Position, taille, opacité et audio configurables via le champ `options`.
Texte en MP3	`text_to_mp3`	(texte uniquement)	Convertit du texte en parole et retourne un fichier MP3. Aucun fichier à envoyer — passez `mode=text_to_mp3`, `text` et `lang` en champs de formulaire. Supporte les 20 langues du site.

Validation stricte : chaque mode exige un nombre et des types de fichiers exacts. add_audio et mix_audio acceptent uniquement 1 MP4 + 1 MP3 (exactement). image_to_video accepte uniquement 1 image JPG/PNG + 1 MP3 (exactement). Toute autre combinaison est rejetée avec un code d'erreur explicite. Les types MIME sont vérifiés par magic bytes, pas seulement par l'extension. Plusieurs MP4 sans champ mode → auto-détection fusion.

Règle de durée : en modes audio et image_to_video, la durée du résultat est calée sur la durée du MP3. La piste vidéo n'est jamais réencodée en modes audio (-c:v copy).

Paramètres communs (multipart/form-data)

Champ	Type	Req.	Description
videos[]	File[]	OUI	Fichiers à traiter. Selon le mode : 2–20 MP4, ou 1 MP4 + 1 MP3, ou 1 image (JPG/PNG) + 1 MP3. Max 500 MB par fichier.
mode	string	*	`image_to_video` \| `add_audio` \| `mix_audio`. Obligatoire pour ces trois modes. Ignoré (et auto-détecté) uniquement si tous les fichiers sont MP4 (`fusion`). Pour modifier l'audio : `add_audio` supprime l'original, `mix_audio` le conserve et superpose. Si le champ `mode` est fourni, les fichiers envoyés doivent correspondre exactement — sinon la requête est rejetée.
order	JSON		Mode `fusion` uniquement — tableau JSON des indices définissant l'ordre des clips.
transition_type	string		Mode `fusion` uniquement. Défaut : `none`. Voir la liste des transitions disponibles.
transition_duration	float		Mode `fusion` uniquement. Durée 0.2–2.0 s. Défaut : `0.5`.
options	JSON		Mode `image_to_video` uniquement — objet JSON de paramètres de rendu (voir ci-dessous).
callback_url	string		URL publique (http/https) appelée en fin de job. La réponse inclut un `webhook_secret`.

Paramètres `options` — mode image_to_video

Tous optionnels. Valeurs non fournies → defaults appliqués par le worker.

Clé	Type	Défaut	Description
text	string	""	Texte affiché en overlay. Vide = pas de texte. Max 500 caractères.
font_size	int	60	Taille de police en pixels. Plage : 10–300. Valeurs conseillées : 36, 48, 60, 72, 96.
text_color	string	"white"	Couleur du texte (ex: `white`, `yellow`, `#ffffff`, `0xffffff`).
text_position	string	"center"	Position du texte : `center`, `top`, `bottom`.
box	bool	true	Fond semi-transparent derrière le texte.
box_color	string	"black@0.4"	Couleur + opacité du fond texte au format FFmpeg : `couleur@opacité`. Couleurs : `black`, `white`, `yellow`, `#ff4444`, `#00ccff`, `#ff8800`, `#ff69b4`… Opacité : 0.0–1.0 (ex: `black@0.4` = noir à 40%, `white@0.70` = blanc à 70%).
fade_duration	float	0.5	Durée du fondu in/out en secondes (0–2). Le texte est inclu dans le fondu. 0 = pas de fondu.
width	int	1080	Largeur vidéo en pixels (64–3840, forcé pair). Combos standard : 1080/1920/720/1280.
height	int	1920	Hauteur vidéo en pixels (64–3840, forcé pair).
fps	int	24	Fréquence d'images (1–60).
image_fit	string	"contain"	Mode de cadrage : `contain` = l'image entière est visible, les bandes vides sont remplies par `bg_color` (letterbox/pillarbox) ; `cover` = l'image est zoomée pour remplir le cadre entier, centrée, les bords excédentaires sont rognés (aucune bande noire). Le paramètre `bg_color` est ignoré en mode `cover`.
bg_color	string	"black"	Couleur de fond (padding) si l'image ne remplit pas la résolution cible — pertinent uniquement avec `image_fit=contain` (ex: `black`, `white`, `#1a1a2e`).
enable_image_motion	bool	false	Active l'animation de la photo. Si `false`, l'image reste statique. Si `true`, l'effet défini par `image_motion_effect` est appliqué via le filtre FFmpeg `zoompan`.
image_motion_effect	string	"ken_burns"	Effet d'animation (ignoré si `enable_image_motion` est `false`). Valeurs acceptées : `zoom_in`, `zoom_out`, `pan_left_to_right`, `pan_right_to_left`, `pan_top_to_bottom`, `pan_bottom_to_top`, `zoom_pan_soft`, `ken_burns`. Valeur par défaut si absente ou invalide : `ken_burns`.
motion_intensity	float	1.0	Intensité de l'animation photo (0.25–2.0). Multiplie l'amplitude du zoom et la vitesse des panoramiques. `0.25` = très subtil, `1.0` = comportement par défaut, `2.0` = double amplitude. Ignoré si `enable_image_motion` est `false`.
text_effect	string	"none"	Animation du texte overlay (ignoré si `text` est absent ou si `text_mode` vaut `word_by_word`). Valeurs acceptées : `none`, `fade_in` (fondu d'apparition), `slide_up` (entrée par le bas), `slide_down` (entrée par le haut), `slide_left` (entrée par la droite), `bounce` (oscillation verticale continue).
text_effect_intensity	float	1.0	Intensité de l'animation du texte (0.25–2.0). Contrôle la vitesse du fondu, la durée d'entrée des glissements, ou la fréquence et amplitude du rebond. Ignoré si `text_effect` est `none`.
text_border_width	int	0	Épaisseur du contour noir autour des caractères, en pixels (0 = désactivé, 1–10). Améliore la lisibilité sur fonds clairs ou colorés. Ignoré si `text` est absent.
text_mode	string	"static"	Mode d'affichage du texte. `static` (défaut) : texte visible dès la première image. `word_by_word` : les mots apparaissent un par un au rythme défini par `word_reveal_speed`. Mutuellement exclusif avec `text_effect` : si `text_mode=word_by_word`, `text_effect` est ignoré.
word_reveal_speed	float	1.5	Vitesse de révélation en mots par seconde (0.3–5.0, défaut 1.5). Utilisé uniquement avec `text_mode=word_by_word`. Valeur recommandée pour la synchro avec une voix OpenAI TTS : 2.0.
word_anim	string	"none"	Animation à l'apparition de chaque mot. `none` (défaut) : révélation instantanée. `fade` : chaque nouveau mot apparaît en fondu sur 0.2s avec un crossfade vers le bloc précédent. Utilisé uniquement si `text_mode=word_by_word`.

Paramètres `options` — mode overlay_video

Tous optionnels. L'ordre d'envoi est important : le premier fichier est la vidéo principale (fond), le deuxième fichier est l'overlay (avant-plan). Utilisez chroma_key pour supprimer un fond vert de l'overlay.

Clé	Type	Défaut	Description
position	string	"bottom-right"	Coin où l'overlay est placé : `top-left`, `top-right`, `bottom-left`, `bottom-right`, ou `center`.
scale	float	0.30	Taille de l'overlay en fraction de la largeur de la vidéo principale. `0.25` = 25% de la largeur. Plage : 0.05–1.0.
opacity	float	1.0	Transparence de l'overlay. `1.0` = totalement opaque, `0.0` = invisible.
margin	int	10	Écart en pixels entre l'overlay et le bord de l'image. Ignoré si `position=center`. Plage : 0–200.
audio	string	"main"	Piste audio à conserver. `main` : uniquement la vidéo principale. `overlay` : uniquement l'overlay. `mix` : les deux pistes mélangées à volume égal.
chroma_key	bool	false	Mettre à `true` pour supprimer le fond vert pur (#00FF00) de l'overlay — utile pour une incrustation webcam ou une animation filmée sur fond vert.
chroma_similarity	float	0.20	Tolérance du chroma key. Faible = correspondance stricte (préserve les contours du sujet). Élevée = suppression plus large (compense l'éclairage irrégulier). Recommandé : `0.10–0.20` pour un fond vert numérique, `0.25–0.45` pour un écran physique. Plage : 0.01–0.60.

Paramètres `options` — Modifier l'audio (`mix_audio`)

Disponible uniquement avec mode=mix_audio. Ignoré pour add_audio.

Clé	Type	Défaut	Description
mp3_volume	float	1.0	Volume du MP3 superposé (0.0 = muet, 1.0 = volume original, 2.0 = double). Valeurs au-delà de 1.0 peuvent saturer.

Réponse succès (HTTP 200)

{
  "success": true,
  "job_id": "a3f1c8d2e5b09471...",
  "mode": "fusion",              // "fusion" | "add_audio" | "mix_audio" | "image_to_video" | "overlay_video"
  "file_count": 2,
  "transition": null,
  "quota_used": 1,
  "quota_remaining": 9,
  "status_url": "https://rapidvideomaker.com/api/v1/jobs.php?job_id=a3f1c8..."
}

Exemple curl — mode image_to_video

curl -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@scene.jpg" \
  -F "videos[]=@narration.mp3" \
  -F "mode=image_to_video" \
  -F 'options={"text":"Chapter 1","font_size":72,"text_color":"white","text_position":"bottom","box":true,"box_color":"black@0.4","fade_duration":0.5,"width":1080,"height":1920,"image_fit":"contain","bg_color":"black","enable_image_motion":true,"image_motion_effect":"ken_burns","motion_intensity":1.0,"text_effect":"slide_up","text_effect_intensity":1.0}'
# image_fit           : "contain" | "cover"
# bg_color            : ignored if image_fit="cover"
# enable_image_motion : true = animation on, false (default) = static image
# image_motion_effect : zoom_in | zoom_out | pan_left_to_right | pan_right_to_left | pan_top_to_bottom | pan_bottom_to_top | zoom_pan_soft | ken_burns
# motion_intensity    : 0.25–2.0 — photo animation amplitude (default 1.0)
# text_effect         : none | fade_in | slide_up | slide_down | slide_left | bounce (ignored if text_mode=word_by_word)
# text_effect_intensity : 0.25–2.0 — text animation intensity (default 1.0)
# text_border_width   : 0–10 px — black outline around characters (0 = disabled)
# text_mode           : "static" (default) | "word_by_word" — reveal words one by one
# word_reveal_speed   : 0.3–5.0 w/s — speed for word_by_word mode (default 1.5, ~2.0 for OpenAI TTS)
# word_anim           : "none" (default) | "fade" — fade-in crossfade on each word (word_by_word only)

Exemple curl — Modifier l'audio

# Replace audio (deletes original)
curl -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@my_video.mp4" \
  -F "videos[]=@my_music.mp3" \
  -F "mode=add_audio"

# Keep original audio + overlay MP3
curl -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@my_video.mp4" \
  -F "videos[]=@my_music.mp3" \
  -F "mode=mix_audio" \
  -F 'options={"mp3_volume":0.7}'
# mp3_volume : 0.0 (muted) → 1.0 (original volume, default) → 2.0 (amplified)

Exemple curl — mode overlay_video

curl -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@main_video.mp4" \
  -F "videos[]=@overlay_video.mp4" \
  -F "mode=overlay_video" \
  -F 'options={"position":"bottom-right","scale":0.25,"opacity":1.0,"margin":20,"audio":"main"}'

# Green screen overlay
curl -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@main_video.mp4" \
  -F "videos[]=@webcam_greenscreen.mp4" \
  -F "mode=overlay_video" \
  -F 'options={"position":"bottom-left","scale":0.35,"chroma_key":true,"chroma_similarity":0.15,"audio":"mix"}'
# position           : top-left | top-right | bottom-left | bottom-right | center (default: bottom-right)
# scale              : 0.05–1.0 — overlay width as fraction of main video (default 0.30)
# opacity            : 0.0–1.0 — overlay transparency (default 1.0)
# margin             : 0–200 px — gap from frame edge, ignored if center (default 10)
# audio              : main | overlay | mix — audio to keep (default: main)
# chroma_key         : true | false — remove green (#00FF00) background from overlay (default false)
# chroma_similarity  : 0.01–0.60 — green screen tolerance (default 0.20)

Exemple curl — Fusionner des vidéos

curl -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@clip1.mp4" \
  -F "videos[]=@clip2.mp4" \
  -F "transition_type=fade" \
  -F "transition_duration=0.5"

Statuts possibles

Statut	Signification	Champs supplémentaires
queued	En file d'attente, pas encore traité	`queue_position`, `queue_total`, `eta_minutes`
processing	Traitement FFmpeg en cours	—
ready	Terminé — fichier disponible	`download_url`, `created_at`, `expires_at`
error	Échec du traitement	`error` (message)

Réponses selon le statut

queued

{
  "job_id": "a3f1c8...",
  "status": "queued",
  "queue_position": 2,
  "queue_total": 3,
  "eta_minutes": 7
}

ready

{
  "job_id": "a3f1c8...",
  "status": "ready",
  "download_url": "https://rapidvideomaker.com/api/download.php?job_id=a3f1c8...",
  "created_at": "2026-06-02T10:00:00+00:00",
  "expires_at": "2026-06-02T12:00:00+00:00"
}

Exemple curl

curl -H "Authorization: Bearer rvm_your_token" \
  "https://rapidvideomaker.com/api/v1/jobs.php?job_id=a3f1c8..."

Paramètres communs (multipart/form-data)

apidocs_th_param	Type	Défaut	apidocs_th_desc
`page`	integer	1	Numéro de page (commence à 1)
`limit`	integer	20	Résultats par page (max 50, défaut 20)

Réponses selon le statut

{
  "success": true,
  "jobs": [
    { "job_id": "a3f1c8...", "status": "ready", "mode": "fusion", "created_at": "2026-06-02T10:00:00+00:00", "expires_at": "2026-06-02T12:00:00+00:00", "download_url": "https://..." },
    ...
  ],
  "total": 12,
  "page": 1,
  "limit": 20
}

Publie un job terminé (status=ready) sur un ou plusieurs comptes sociaux. Le token doit appartenir à un compte membre (pas un token admin).

Prérequis : Les comptes sociaux (YouTube, TikTok) doivent être connectés au préalable via OAuth dans la page Publications de votre espace membre. L'account_id de chaque compte est affiché sur cette page.

Paramètres communs (multipart/form-data)

apidocs_th_param	Type	apidocs_th_required	apidocs_th_desc
`job_id`	string	apidocs_required	ID du job (hex 32 chars) de la vidéo terminée
`publications`	array	apidocs_required	Tableau d'objets de publication (max 10)

Objet publication

apidocs_th_param	Type	apidocs_th_required	apidocs_th_desc
`account_id`	integer	apidocs_required	ID du compte social connecté — visible sur la page Publications de votre espace membre
`title`	string	—	Titre de la vidéo (max 512 caractères)
`description`	string	—	Description de la vidéo (max 5 000 caractères)
`tags`	string	—	Tags séparés par des virgules (max 1 024 caractères)
`visibility`	string	—	`public` \| `private` \| `unlisted` — Défaut : public
`tiktok_mode`	string	—	`draft` \| `direct` — TikTok uniquement — défaut : direct
`tiktok_privacy`	string	mode direct	TikTok uniquement — requis en mode direct
`allow_comment`	boolean	—	TikTok uniquement — autoriser les commentaires
`allow_duet`	boolean	—	TikTok uniquement — autoriser les duos
`allow_stitch`	boolean	—	TikTok uniquement — autoriser les stitches
`your_brand`	boolean	—	TikTok uniquement — contenu promotionnel organique (« Votre marque »).
`branded_content`	boolean	—	TikTok uniquement — contenu de marque (branded content)
`tiktok_cover_ms`	integer	—	TikTok uniquement — timestamp de la frame de couverture en ms (0–60 000, défaut 1 000)

Réponses selon le statut

{
  "success": true,
  "results": [
    {
      "account_id": 12,
      "pub_id": 47,
      "status": "published",
      "provider": "youtube",
      "url": "https://youtu.be/abc123"
    }
  ]
}

Codes d'erreur par publication

apidocs_th_code	Signification
`job_not_ready`	Job pas encore terminé
`mode_not_supported`	Les jobs text_to_mp3 ne peuvent pas être publiés
`account_not_found`	Compte introuvable ou déconnecté
`tiktok_privacy_required`	Niveau de confidentialité requis en mode direct
`publication_failed`	Le provider a retourné une erreur lors de l'upload

Exemple cURL

curl -X POST https://rapidvideomaker.com/api/v1/publish.php \
  -H "Authorization: Bearer rvm_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "a3f1c8...",
    "publications": [
      {
        "account_id": 12,
        "title": "My video",
        "description": "Created with RapidVideoMaker",
        "visibility": "public"
      }
    ]
  }'

Retourne le fichier MP4 final en streaming (Content-Type: video/mp4). Ne nécessite pas de token — l'URL est suffisamment opaque. Disponible uniquement si le statut est ready.

Le fichier est conservé 2 heures après la fin du job, puis supprimé. Téléchargez-le dès que le statut passe à ready.

Paramètre optionnel

Paramètre	Description
filename	Nom suggéré pour le fichier téléchargé (ex: `ma-video.mp4`)

Exemple curl

curl -o "output.mp4" \
  "https://rapidvideomaker.com/api/download.php?job_id=a3f1c8...&filename=output.mp4"

Webhooks

Le webhook est une alternative au polling : au lieu d'interroger le statut toutes les X secondes, vous fournissez une URL et le serveur vous appelle automatiquement quand le job se termine.

Fonctionnement

Passez callback_url dans le POST /api/v1/render.php
La réponse contient un webhook_secret — conservez-le pour vérifier les signatures
Quand le job passe à ready ou error, le serveur envoie un POST JSON signé vers votre URL
Vérifiez la signature avec HMAC-SHA256(webhook_secret, corps_brut)

Contraintes : callback_url doit être une URL publiquement accessible (http ou https). Les adresses IP privées, loopback et réservées sont bloquées côté serveur. Timeout : 10 secondes.

Payload reçu

Succès (ready)

{
  "job_id": "a3f1c8...",
  "status": "ready",
  "download_url": "https://rapidvideomaker.com
  /api/download.php?job_id=a3f1c8...",
  "timestamp": "2026-04-04T12:00:00+00:00"
}

Échec (error)

{
  "job_id": "a3f1c8...",
  "status": "error",
  "error": "FFmpeg xfade failed:...",
  "timestamp": "2026-04-04T12:00:00+00:00"
}

Headers envoyés par le serveur

Header	Valeur
Content-Type	`application/json`
X-RVM-Signature	`sha256=<hmac_hex>` — signature HMAC-SHA256 du corps brut
X-RVM-Job-Id	Le `job_id` concerné

Vérification de la signature

# Python
import hmac, hashlib

def verify_webhook(secret: str, body: bytes, signature_header: str) -> bool:
    expected = "sha256=" + hmac.new(
        secret.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature_header)

# Flask/FastAPI endpoint:
sig    = request.headers.get("X-RVM-Signature", "")
if not verify_webhook(WEBHOOK_SECRET, request.data, sig):
    return "Invalid signature", 403
data = request.get_json()

Codes d'erreur

HTTP	code JSON	Cause
401	unauthorized	Token absent, invalide ou révoqué
400	missing_files	Aucun fichier reçu
400	too_few_files	Moins de 2 fichiers envoyés
400	too_many_files	Plus de 20 fichiers envoyés
400	invalid_mime	Fichier non supporté — seuls MP4, MP3 et images JPG/PNG sont acceptés (MIME vérifié par magic bytes)
400	wrong_file_count	Le nombre de fichiers ne correspond pas au mode choisi (ex : 3 fichiers avec `mode=add_audio` qui en exige 2)
400	wrong_file_types	Les types de fichiers ne correspondent pas au mode choisi (ex : 2 MP4 avec `mode=add_audio` qui exige 1 MP4 + 1 MP3 ; ou 1 MP4 + 1 MP3 avec `mode=image_to_video`)
400	invalid_file_combination	Combinaison de fichiers sans mode précisé ne correspond à aucun mode supporté
400	invalid_options	Le champ `options` n'est pas un JSON valide ou contient un objet attendu
400	invalid_option	Une valeur dans `options` est invalide (couleur, nom de police, position…)
400	file_too_large	Un fichier dépasse 500 MB
400	invalid_order	Le tableau `order` n'est pas une permutation valide
400	invalid_job_id	Format job_id incorrect (doit être hex 32 chars)
404	job_not_found	Job introuvable — `job_id` inconnu ou jamais existé
410	job_expired	Job expiré — a existé mais la fenêtre de récupération de 2 h est dépassée
429	quota_exceeded	10 jobs réussis/jour atteints (tous modes confondus)
429	rate_limited	Plus de 12 appels/min sur `/api/v1/jobs.php` — attendre `Retry-After` secondes
500	server_error	Erreur interne serveur

Exemples d'intégration

Exemples pour chaque mode — installe requests avec pip install requests.

Configuration commune

import requests, time, sys, json

API_BASE  = "https://rapidvideomaker.com"
API_TOKEN = "rvm_your_token_here"
HEADERS   = {"Authorization": f"Bearer {API_TOKEN}"}

Mode image_to_video — image + audio → vidéo

with open("scene.jpg", "rb") as fi, open("narration.mp3", "rb") as fa:
    resp = requests.post(
        f"{API_BASE}/api/v1/render.php",
        headers=HEADERS,
        files=[
            ("videos[]", ("scene.jpg", fi, "image/jpeg")),
            ("videos[]", ("narration.mp3", fa, "audio/mpeg")),
        ],
        data={
            "mode": "image_to_video",
            "options": json.dumps({
                "text":          "Chapter 1",
                "font_size":     72,
                "text_color":    "white",
                "text_position": "bottom",
                "box":           True,
                "box_color":     "black@0.4",
                "fade_duration": 0.5,
                "width":              1080,
                "height":             1920,
                "image_fit":          "contain",  # "contain" | "cover"
                "bg_color":           "black",    # ignored if image_fit="cover"
                "enable_image_motion": True,
                "image_motion_effect": "ken_burns",
                "motion_intensity":    1.0,        # 0.25–2.0 — photo animation amplitude
                "text_effect":         "slide_up", # none | fade_in | slide_up | slide_down | slide_left | bounce (ignored if text_mode=word_by_word)
                "text_effect_intensity": 1.0,      # 0.25–2.0 — text animation intensity
                # word-by-word reveal (mutually exclusive with text_effect):
                # "text_mode": "word_by_word", "word_reveal_speed": 2.0, "word_anim": "fade"
            }),
        },
    )

Modifier l'audio

# Replace audio (deletes original) — mode=add_audio
with open("video.mp4", "rb") as fv, open("music.mp3", "rb") as fa:
    resp = requests.post(
        f"{API_BASE}/api/v1/render.php",
        headers=HEADERS,
        files=[
            ("videos[]", ("video.mp4", fv, "video/mp4")),
            ("videos[]", ("music.mp3", fa, "audio/mpeg")),
        ],
        data={"mode": "add_audio"},
    )

# Keep original audio + overlay MP3 — mode=mix_audio
with open("video.mp4", "rb") as fv, open("music.mp3", "rb") as fa:
    resp = requests.post(
        f"{API_BASE}/api/v1/render.php",
        headers=HEADERS,
        files=[
            ("videos[]", ("video.mp4", fv, "video/mp4")),
            ("videos[]", ("music.mp3", fa, "audio/mpeg")),
        ],
        data={"mode": "mix_audio", "options": json.dumps({"mp3_volume": 0.7})},
        # mp3_volume : 0.0 = muted, 1.0 = original volume (default), 2.0 = amplified
    )

Mode overlay_video — incrustation vidéo (picture-in-picture)

with open("main.mp4", "rb") as fm, open("overlay.mp4", "rb") as fo:
    resp = requests.post(
        f"{API_BASE}/api/v1/render.php",
        headers=HEADERS,
        files=[
            ("videos[]", ("main.mp4",    fm, "video/mp4")),
            ("videos[]", ("overlay.mp4", fo, "video/mp4")),
        ],
        data={
            "mode": "overlay_video",
            "options": json.dumps({
                "position": "bottom-right",  # top-left | top-right | bottom-left | bottom-right | center
                "scale":    0.25,             # 0.05–1.0 — overlay width fraction
                "opacity":  1.0,             # 0.0–1.0 — transparency
                "margin":   20,              # 0–200 px — gap from frame edge
                "audio":    "main",          # main | overlay | mix
                # green screen: "chroma_key": True, "chroma_similarity": 0.15
            }),
        },
    )

Fusionner des vidéos

with open("clip1.mp4", "rb") as f1, open("clip2.mp4", "rb") as f2:
    resp = requests.post(
        f"{API_BASE}/api/v1/render.php",
        headers=HEADERS,
        files=[
            ("videos[]", ("clip1.mp4", f1, "video/mp4")),
            ("videos[]", ("clip2.mp4", f2, "video/mp4")),
        ],
        data={"transition_type": "fade", "transition_duration": "0.5"},
    )

Polling + téléchargement (commun à tous les modes)

resp.raise_for_status()
job_id = resp.json()["job_id"]
print(f"Job created: {job_id}")

for _ in range(120):          # timeout 10 min (120 × 5s)
    r = requests.get(
        f"{API_BASE}/api/v1/jobs.php",
        headers=HEADERS,
        params={"job_id": job_id},
    )
    data   = r.json()
    status = data["status"]

    if status == "queued":
        pos = data.get("queue_position", "?")
        eta = data.get("eta_minutes", "?")
        print(f"Queued — position {pos}, ETA ~{eta} min")
    elif status == "processing":
        print("Processing…")
    elif status == "ready":
        download_url = data["download_url"]
        break
    elif status == "error":
        sys.exit(f"Error: {data.get('error')}")

    time.sleep(5)
else:
    sys.exit("Timeout: job not completed after 10 min")

r = requests.get(download_url, stream=True)
with open("output.mp4", "wb") as f:
    for chunk in r.iter_content(65536):
        f.write(chunk)
print("Downloaded: output.mp4")

Deux approches possibles dans n8n : polling (boucle sur le statut) ou webhook (le serveur appelle n8n). Le webhook est recommandé — plus propre, zéro charge inutile.

Approche A — Webhook (recommandée)

3 nœuds seulement, pas de boucle.

Nœud 1 — Webhook trigger
Ajoutez un nœud Webhook en entrée de workflow (méthode POST). Notez l'URL générée, ex : https://votre-n8n.com/webhook/rvm-callback.

Nœud 2 — Créer le job (HTTP Request)

Méthode	`POST`
URL	`https://rapidvideomaker.com/api/v1/render.php`
Authentification	Header Auth — `Authorization: Bearer rvm_…`
Type de contenu	`Form-Data Multipart`
Body params	Champ Binary `videos[]` pour chaque clip + champ Text `callback_url` = URL du nœud Webhook ci-dessus

Conservez webhook_secret de la réponse dans une variable de workflow pour vérifier la signature à la réception.

Nœud 3 — Traiter le résultat (dans le workflow déclenché par le Webhook)
Quand n8n reçoit le POST du serveur, $json.status vaut ready ou error. Si ready, $json.download_url contient l'URL de téléchargement directe.

Pour vérifier la signature : comparez {{ $headers['x-rvm-signature'] }} avec sha256= + HMAC-SHA256 du corps brut calculé depuis votre webhook_secret. Utilisez un nœud Code avec crypto.createHmac('sha256', secret).update(body).digest('hex').

Approche B — Polling (sans webhook)

5 nœuds, boucle sur le statut toutes les 10 s.

Nœud 1 — Créer le job — même config que ci-dessus, sans callback_url.

Nœud 2 — Wait — 10 secondes.

Nœud 3 — Interroger le statut (HTTP Request GET)

URL	`https://rapidvideomaker.com/api/v1/jobs.php`
Paramètres de requête	`job_id` = `{{ $('Nœud 1').item.json.job_id }}`
Authentification	Header Auth — même token

Nœud 4 — If : {{ $json.status }} === 'ready' → true : Nœud 5 / false : retour Nœud 2.

Ajoutez un compteur d'itérations dans un nœud Set pour couper la boucle après 60 tentatives (10 min max) et éviter une boucle infinie.

Nœud 5 — Télécharger : HTTP Request GET sur {{ $json.download_url }}, Response Format File.

Étape 1 — Créer le job (choisir un mode)

# fusion
JOB=$(curl -s -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@clip1.mp4" -F "videos[]=@clip2.mp4")

# add_audio (replace audio)
JOB=$(curl -s -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@video.mp4" -F "videos[]=@music.mp3" \
  -F "mode=add_audio")

# mix_audio (overlay music at 70% volume)
JOB=$(curl -s -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@video.mp4" -F "videos[]=@music.mp3" \
  -F "mode=mix_audio" -F 'options={"mp3_volume":0.7}')

# image_to_video
JOB=$(curl -s -X POST https://rapidvideomaker.com/api/v1/render.php \
  -H "Authorization: Bearer rvm_your_token" \
  -F "videos[]=@scene.jpg" -F "videos[]=@narration.mp3" \
  -F "mode=image_to_video" \
  -F 'options={"text":"Chapter 1","font_size":72,"text_position":"bottom","fade_duration":0.5,"width":1080,"height":1920}')

JOB_ID=$(echo $JOB | grep -o '"job_id":"[^"]*"' | cut -d'"' -f4)
echo "Job ID: $JOB_ID"

Étape 2 — Polling

while true; do
  STATUS=$(curl -s \
    -H "Authorization: Bearer rvm_your_token" \
    "https://rapidvideomaker.com/api/v1/jobs.php?job_id=$JOB_ID")
  STATE=$(echo $STATUS | grep -o '"status":"[^"]*"' | cut -d'"' -f4)
  echo "Status: $STATE"
  [ "$STATE" = "ready" ] && break
  [ "$STATE" = "error" ] && { echo "Error"; exit 1; }
  sleep 10
done

Étape 3 — Télécharger

DOWNLOAD_URL=$(echo $STATUS | grep -o '"download_url":"[^"]*"' | cut -d'"' -f4)
curl -o output.mp4 "$DOWNLOAD_URL"

Bonnes pratiques

Fréquence de polling : l'endpoint /api/v1/jobs.php est limité à 12 appels/min par token. Respectez au moins 5 secondes entre chaque appel (10 s recommandé) pour éviter un 429. La durée d'un job varie selon le mode et la taille des fichiers (de quelques secondes à plusieurs minutes).
Timeout : implémentez un timeout côté client (ex: 10 minutes). Si le job n'est pas ready après ce délai, considérez-le en erreur.
Téléchargement rapide : dès que le statut est ready, téléchargez le fichier. Il est supprimé 2 heures après la fin du job.
Gestion du quota : vérifiez quota_remaining dans la réponse du POST. Si 0, le prochain job sera refusé avec 429.
Erreurs réseau : en cas d'erreur réseau pendant le polling, attendez et réessayez — le job continue de s'exécuter côté serveur indépendamment.

Les fichiers résultants sont conservés 2 heures après la fin du job, puis supprimés automatiquement. Téléchargez votre vidéo dès que le statut passe à ready.

API RapidVideoMaker

Workflow complet

Authentification

Quota

File d'attente

Transitions disponibles

Endpoints

Paramètres communs (multipart/form-data)

Paramètres options — mode image_to_video

Paramètres options — mode overlay_video

Paramètres options — Modifier l'audio (mix_audio)

Réponse succès (HTTP 200)

Exemple curl — mode image_to_video

Exemple curl — Modifier l'audio

Exemple curl — mode overlay_video

Exemple curl — Fusionner des vidéos

Statuts possibles

Réponses selon le statut

Exemple curl

Paramètres communs (multipart/form-data)

Réponses selon le statut

Paramètres communs (multipart/form-data)

Objet publication

Réponses selon le statut

Codes d'erreur par publication

Exemple cURL

Paramètre optionnel

Exemple curl

Webhooks

Fonctionnement

Payload reçu

Headers envoyés par le serveur

Vérification de la signature

Codes d'erreur

Exemples d'intégration

Configuration commune

Mode image_to_video — image + audio → vidéo

Modifier l'audio

Mode overlay_video — incrustation vidéo (picture-in-picture)

Fusionner des vidéos

Polling + téléchargement (commun à tous les modes)

Approche A — Webhook (recommandée)

Approche B — Polling (sans webhook)

Étape 1 — Créer le job (choisir un mode)

Étape 2 — Polling

Étape 3 — Télécharger

Bonnes pratiques

Paramètres `options` — mode image_to_video

Paramètres `options` — mode overlay_video

Paramètres `options` — Modifier l'audio (`mix_audio`)