Aperçu API

Le Reigniter API permet à vos serveurs de créer des vidéos. Vous envoyez un brief ou un plan de scène, Reigniter rendez la vidéo, et vous collectez les MP4finis. C’est le même moteur de rendu qui Brand Flow fait tourner dans l’application.

Ce que tu peux faire

• Faites une vidéo à partir d’un brief. Décrivez la publicité ou la vidéo de formation en langage clair. Reigniter planifiez les scènes et les rendez.
• Fais une vidéo à partir de ton propre plan de scène. Envoie les scènes toi-même quand tu as besoin de contrôle total sur ce que chacune montre et dit.
• Marquez chaque vidéo. Nommez un de vos kits de marque, ou envoyez un logo et des couleurs.
• Suivez les rendus. Interrogez un travail jusqu’à ce qu’il soit terminé, ou obtenez un webhook quand ce sera fait.
• Vérifiez votre compte. Confirmez qu’une clé fonctionne et lisez votre solde de crédit.

Base URL

https://reigniter.ai/v1

Les abonnements Webhook sont disponibles sous https://reigniter.ai/api/webhooks et utilisent la même API clé.

Demandes et réponses

• Envoyez- JSON avec Content-Type: application/json.
• Chaque réponse est JSON, y compris les erreurs.
• Les rendus tournent en arrière-plan. Démarrer un renvoie 202 Accepted et un job_id immédiatement.
• Appelez le API depuis votre serveur. Ne mettez jamais de clé API dans un navigateur ou une application mobile.

Authentification

Chaque requête nécessite une clé API dans l’en-tête Authorization :

Authorization: Bearer emp_...

Voir Authentification pour savoir comment créer et révoquer des clés.

Qui a accès

API accès fait partie du forfait Agency. Une clé sur tout autre forfait est refusée avec 402 PLAN_UPGRADE_REQUIRED. Voir Compte et facturation pour changer de forfait.

Crédits

Les rendus dépensent les crédits de votre compte, les mêmes crédits que vous utilisez dans l’application. Chaque réponse de rendu vous indique combien de crédits elle a utilisés, et GET /v1/me retourne votre solde. Les coûts de crédit dépendent de la durée, du nombre de scènes et de la qualité de la vidéo. Voir Compte et facturation pour savoir comment fonctionnent les crédits.

Note

Les valeurs exemples sur ces pages, comme les soldes et les credits_used, sont illustratifs. Ce ne sont pas des prix.

Points d’extrémité

Méthode	Chemin	Ce que ça fait
GET	/v1/me	Le compte et le solde de crédit de la clé
POST	/v1/render	Commencez un rendu à partir d’un brief ou d’un plan de scène
GET	/v1/job/{id}	État d’un rendu, et l’URL de la vidéo une fois terminé
GET POST PATCH DELETE	/api/webhooks/...	Gérer les abonnements webhook

Prochaines étapes

• Quickstart : votre première vidéo en cinq étapes.
• Réalisation de vidéos : briefs, plans de scène, marques et produits.
• Webhooks : on vous informe quand une vidéo est prête.
• Erreurs et limites.
• Référence de terminaison : chaque champ de chaque point de terminaison.