Videogen

Une vidéo de présentation pour chaque véhicule de votre stock.

Envoyez vos annonces, récupérez des vidéos verticales prêtes à publier. Génération asynchrone, rendu déterministe, mise à jour automatique quand l'annonce change — sans refacturation.

API v1 — accès sur invitation

Comment ça marche

1. Envoyez l'annonce

Un appel POST avec les données du véhicule, ses photos et votre référence interne. L'API répond immédiatement avec un identifiant de traitement.

2. Suivez le rendu

Progression en temps réel par SSE ou par simple requête d'état. Priorité interactive pour les annonces fraîches, voie lente pour les imports massifs.

3. Publiez la vidéo

Un MP4 vertical 9:16, adressé de façon stable et mis en cache. Si les données de l'annonce changent, la vidéo est régénérée gratuitement.

L'API

Point d'entréeRôle
POST /v1/renders Soumet une annonce (véhicule + configuration). Idempotent : payload inchangé → vidéo existante réutilisée, sans coût.
GET /v1/renders/{id} État, progression, URL de la vidéo, cause d'échec structurée.
GET /v1/renders/{id}/events Flux SSE de progression, un événement par seconde.

Authentification par en-tête X-Api-Key. Exemple : 

curl -X POST https://videogen.mickaaado.fr/v1/renders \
  -H "X-Api-Key: vgk_…" -H "Content-Type: application/json" \
  -d '{
    "externalRef": "ANNONCE-42",
    "vehicle": {
      "marque": "Peugeot", "modele": "3008", "prix": 32900,
      "photos": [{ "url": "https://…/photo1.jpg" }],
      "agence": { "nom": "Mon Agence", "ville": "Lyon" }
    },
    "config": { "tier": "premium", "transition": "balayage" }
  }'

Ce qui est inclus

Gabarits & tiers

Modèle standard aujourd'hui, bibliothèque de modèles à venir. Tiers standard (720p) et premium (1080p), transitions configurables (balayage, fondu, glissement).

Dégradation maîtrisée

Annonce sans prix, sans équipements, avec une seule photo ou des photos inaccessibles : la vidéo reste publiable, les scènes impossibles sont retirées, jamais rendues vides.

Rendu déterministe

Mêmes données, même vidéo, à l'octet près. C'est ce qui permet le cache, les rejeux gratuits et une facturation exacte.