Hookzen,
desde tu código.
Las mismas herramientas que en la web, en REST: buscar vídeos virales, analizar su estructura, escribir un guion, preparar una edición.
Base de la API: https://hookzen.app/api/v1
Las rutas
GET/accountSaldo, plan, cuota y últimas operaciones de la cuentaGET/formatsCatálogo de formatos virales, de más a menos vistos (gratis)POST/searchSuper Search: buscar vídeos viralesPOST/variantsVariantes de un vídeo (mismo formato, otros temas)GET/videos/{id}/analysisAnálisis de un vídeo: hook, estructura, ritmo, razones del éxitoPOST/scriptsScript Studio: escribir un guion (2 créditos)POST/montageAuto Montage: plan de edición a partir de la transcripción de las grabaciones (15 créditos por vídeo)
Costes en créditos
- Catálogo de formatos, búsqueda, variantes, análisis de un vídeo
- Gratis
- Guion
- 2 créditos
- Plan de edición
- 15 créditos por vídeo (hasta 10 min de grabación, luego 5 créditos por cada tramo de 5 min)
Los créditos se reembolsan si la IA falla. Con la cabecera Idempotency-Key, una petición reenviada tras un corte nunca se cobra dos veces.
Ejemplo: escribir un guion
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": "Botella térmica", "referenceVideoId": "vid_010"}'La respuesta contiene el guion, los créditos cobrados, el nuevo saldo y los subtítulos en formato SRT.
Los errores
Todos los errores tienen la forma { "error": "message" }. Cada respuesta lleva una cabecera X-Request-Id: indícala al soporte si hay algún problema.
400Parámetros no válidos (el detalle por campo está en issues)Corrige la petición: el campo afectado y el problema se indican en issues.401Clave API ausente o no válidaComprueba la cabecera Authorization: Bearer <clave> y la clave en tu cuenta.402Créditos insuficientesRecarga créditos y vuelve a enviar la petición.404Vídeo desconocido en la bibliotecaComprueba el identificador del vídeo (vid_…) o su enlace.409Petición con la misma Idempotency-Key todavía en cursoEspera unos segundos y vuelve a enviar la misma petición con la misma clave.413Cuerpo de la petición demasiado grandeReduce el tamaño del cuerpo de la petición.415Cuerpo de la petición no declarado como JSON (Content-Type: application/json)Añade la cabecera Content-Type: application/json.422Idempotency-Key ya usada para otra peticiónUsa una nueva Idempotency-Key para una petición distinta.429Demasiadas llamadas o cuota de Super Search alcanzada (ver Retry-After)Espera el tiempo indicado por Retry-After. Sin esa cabecera, la cuota del mes está agotada: no sirve de nada reintentar.502El modelo de IA no terminó (créditos reembolsados)Vuelve a enviar la petición: los créditos se han reembolsado.
Para empezar
- 01
Consigue una clave
Las claves API estarán disponibles en tu cuenta cuando se abran las cuentas. Regístrate para que te avisemos.
- 02
Importa la especificación
Postman, Insomnia, una acción de GPT personalizado o un generador de clientes: todo parte de /api/v1/openapi.json.
- 03
Llama a la API
Autenticación con la cabecera Authorization: Bearer. Cada respuesta lleva un X-Request-Id para indicarlo al soporte.