Hookzen,
dal tuo codice.
Gli stessi strumenti del sito, in REST: cercare video virali, analizzarne la struttura, scrivere uno script, preparare un montaggio.
Base dell'API: https://hookzen.app/api/v1
Le rotte
GET/accountSaldo, piano, quota e ultime operazioni dell'accountGET/formatsCatalogo dei formati virali, dai più visti ai meno visti (gratis)POST/searchSuper Search: cercare video viraliPOST/variantsVarianti di un video (stesso formato, altri temi)GET/videos/{id}/analysisAnalisi di un video: hook, struttura, ritmo, motivi del successoPOST/scriptsScript Studio: scrivere uno script (2 crediti)POST/montageAuto Montage: piano di montaggio dalla trascrizione del girato (15 crediti per video)
Costi in crediti
- Catalogo dei formati, ricerca, varianti, analisi di un video
- Gratis
- Script
- 2 crediti
- Piano di montaggio
- 15 crediti per video (fino a 10 min di girato, poi 5 crediti per ogni blocco di 5 min)
I crediti vengono rimborsati se l'IA fallisce. Con l'header Idempotency-Key, una richiesta reinviata dopo un'interruzione non viene mai addebitata due volte.
Esempio: scrivere uno script
curl -X POST https://hookzen.app/api/v1/scripts \
-H "Authorization: Bearer $HOOKZEN_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "content-type: application/json" \
-d '{"product": "Borraccia termica", "referenceVideoId": "vid_010"}'La risposta contiene lo script, i crediti addebitati, il nuovo saldo e i sottotitoli in formato SRT.
Gli errori
Tutti gli errori hanno la forma { "error": "message" }. Ogni risposta contiene un header X-Request-Id: indicalo all'assistenza in caso di problemi.
400Parametri non validi (il dettaglio per campo è in issues)Correggi la richiesta: il campo interessato e il problema sono indicati in issues.401Chiave API mancante o non validaControlla l'header Authorization: Bearer <chiave> e la chiave nel tuo account.402Crediti insufficientiRicarica i crediti, poi reinvia la richiesta.404Video non presente nella libreriaControlla l'identificativo del video (vid_…) o il suo link.409Richiesta con la stessa Idempotency-Key ancora in corsoAttendi qualche secondo, poi reinvia la stessa richiesta con la stessa chiave.413Corpo della richiesta troppo grandeRiduci la dimensione del corpo della richiesta.415Corpo della richiesta non dichiarato come JSON (Content-Type: application/json)Aggiungi l'header Content-Type: application/json.422Idempotency-Key già usata per un'altra richiestaUsa una nuova Idempotency-Key per una richiesta diversa.429Troppe chiamate o quota Super Search raggiunta (vedi Retry-After)Attendi il tempo indicato da Retry-After. Senza questo header, la quota del mese è esaurita: inutile riprovare.502Il modello di IA non ha completato (crediti rimborsati)Reinvia la richiesta: i crediti sono stati rimborsati.
Per iniziare
- 01
Ottieni una chiave
Le chiavi API saranno disponibili nel tuo account all'apertura degli account. Iscriviti per essere avvisato.
- 02
Importa la specifica
Postman, Insomnia, un'azione di GPT personalizzato o un generatore di client: tutto parte da /api/v1/openapi.json.
- 03
Chiama l'API
Autenticazione tramite l'header Authorization: Bearer. Ogni risposta contiene un X-Request-Id da indicare all'assistenza.