Hookzen,
direto do seu código.
As mesmas ferramentas do site, em REST: buscar vídeos virais, analisar a estrutura deles, escrever um roteiro, preparar uma edição.
Base da API: https://hookzen.app/api/v1
As rotas
GET/accountSaldo, plano, cota e últimas operações da contaGET/formatsCatálogo dos formatos virais, dos mais aos menos vistos (grátis)POST/searchSuper Search: buscar vídeos viraisPOST/variantsVariações de um vídeo (mesmo formato, outros temas)GET/videos/{id}/analysisAnálise de um vídeo: hook, estrutura, ritmo, motivos do sucessoPOST/scriptsScript Studio: escrever um roteiro (2 créditos)POST/montageAuto Montage: plano de edição a partir da transcrição das gravações (15 créditos por vídeo)
Custos em créditos
- Catálogo de formatos, busca, variações, análise de um vídeo
- Grátis
- Roteiro
- 2 créditos
- Plano de edição
- 15 créditos por vídeo (até 10 min de gravação, depois 5 créditos a cada 5 min adicionais)
Os créditos são reembolsados se a IA falhar. Com o cabeçalho Idempotency-Key, uma requisição reenviada após uma queda de conexão nunca é cobrada duas vezes.
Exemplo: escrever um roteiro
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": "Garrafa térmica", "referenceVideoId": "vid_010"}'A resposta contém o roteiro, os créditos debitados, o novo saldo e as legendas em formato SRT.
Os erros
Todos os erros têm o formato { "error": "message" }. Cada resposta traz um cabeçalho X-Request-Id: informe-o ao suporte se houver algum problema.
400Parâmetros inválidos (o detalhe por campo está em issues)Corrija a requisição: o campo em questão e o problema estão indicados em issues.401Chave de API ausente ou inválidaVerifique o cabeçalho Authorization: Bearer <chave> e a chave na sua conta.402Créditos insuficientesRecarregue créditos e reenvie a requisição.404Vídeo não encontrado na bibliotecaVerifique o identificador do vídeo (vid_…) ou o link dele.409Requisição com a mesma Idempotency-Key ainda em andamentoAguarde alguns segundos e reenvie a mesma requisição com a mesma chave.413Corpo da requisição grande demaisReduza o tamanho do corpo da requisição.415Corpo da requisição não declarado como JSON (Content-Type: application/json)Adicione o cabeçalho Content-Type: application/json.422Idempotency-Key já usada em outra solicitaçãoUse uma nova Idempotency-Key para uma solicitação diferente.429Chamadas demais ou cota do Super Search atingida (veja Retry-After)Aguarde o tempo indicado em Retry-After. Sem esse cabeçalho, a cota do mês foi atingida: não adianta tentar de novo.502O modelo de IA não concluiu (créditos reembolsados)Reenvie a requisição: os créditos foram reembolsados.
Para começar
- 01
Obtenha uma chave
As chaves de API estarão disponíveis na sua conta quando as contas forem abertas. Cadastre-se para ser avisado.
- 02
Importe a especificação
Postman, Insomnia, uma ação de GPT personalizado ou um gerador de cliente: tudo parte de /api/v1/openapi.json.
- 03
Chame a API
Autenticação pelo cabeçalho Authorization: Bearer. Cada resposta traz um X-Request-Id para informar ao suporte.