API panoramica

Inizia Reigniter rendering video dal tuo codice, consulta i video e ottieni il video finito.

Il Reigniter API permette ai tuoi server di realizzare video. Mandi un brief o un piano di scena, Reigniter renderizzi il video e raccogli il MP4finito. È lo stesso motore di rendering che esegue Brand Flow nell’app.

Cosa puoi fare

Realizza un video a partire da un brief. Descrivi la pubblicità o il video di formazione in modo chiaro. Reigniter pianifica le scene e le renderizza.
Fai un video dal tuo piano di scena. Invia le scene tu stesso quando hai bisogno di avere il pieno controllo su ciò che ognuna mostra e dice.
Marca ogni video. Nomina uno dei tuoi kit di marca, oppure invia un logo e colori.
Traccia i render. Interroga un lavoro finché non finisce, oppure fai un webhook quando finisce.
Controlla il tuo conto. Verifica che una chiave funziona e leggi il tuo saldo creditizio.

Base URL

https://reigniter.ai/v1

Gli abbonamenti Webhook sono attivi sotto https://reigniter.ai/api/webhooks e usano la API chiave.

Richieste e risposte

Invia JSON con Content-Type: application/json.
Ogni risposta è JSON, compresi gli errori.
I render girano in background. Avviarne uno restituisce subito 202 Accepted e un job_id.
Chiama il API dal tuo server. Non inserire mai una chiave API in un browser o in un’app mobile.

Autenticazione

Ogni richiesta necessita di una chiave API nell’intestazione Authorization:

Authorization: Bearer emp_...

Vedi Autenticazione per come creare e revocare chiavi.

Chi ha accesso

API accesso fa parte del piano Agency. Una chiave su qualsiasi altro piano viene rifiutata con 402 PLAN_UPGRADE_REQUIRED. Vedi Account e fatturazione per cambiare piano.

Crediti

I render spendono i crediti del tuo conto, gli stessi crediti che usi nell’app. Ogni risposta di render ti dice quanti crediti ha usato e GET /v1/me restituisce il tuo saldo. I costi di credito dipendono dalla lunghezza, dal numero di scene e dalla qualità del video. Vedi Account e fatturazione per come funzionano i crediti.

Punti finali

Metodo	Percorso	Cosa fa
`GET`	`/v1/me`	Il conto della chiave e il saldo creditizio
`POST`	`/v1/render`	Inizia un rendering da un brief o da un piano di scena
`GET`	`/v1/job/{id}`	Stato di un render e l’URL del video una volta terminato
`GET` `POST` `PATCH` `DELETE`	`/api/webhooks/...`	Gestire gli abbonamenti webhook

Passi successivi

Quickstart: il tuo primo video in cinque passaggi.
Realizzare video: brief, progetti di scena, marchi e prodotti.
Webhook: vieni avvisato quando un video è pronto.
Errori e limiti.
Riferimento endpoint: ogni campo di ogni endpoint.