v1 — Estável

GenZMakers API

Integre corte automático de vídeos com IA diretamente na sua aplicação. Envie uma URL, receba os melhores momentos virais prontos para postar.

Base URL: https://genzmakers.com.br

Autenticação

Toda requisição autenticada exige o header x-api-key com sua chave pessoal.

Como obter sua API Key

1Acesse o Dashboard e compre créditos (mínimo 100)
2Clique no botão "API" no canto superior direito do Dashboard
3Clique em "Gerar Chave de API" e escolha o prazo de validade
4Copie a chave — ela é exibida apenas UMA vez
5Use no header de cada requisição: x-api-key: gz_live_...
Gerar minha API Key →
http
POST /api/v1/video HTTP/1.1
Host: genzmakers.com.br
x-api-key: gz_live_SUA_CHAVE_AQUI
Content-Type: application/json
⚠️ Nunca exponha sua chave no frontend. Faça chamadas via backend. A chave é exibida apenas uma vez na criação — guarde em variável de ambiente.

Rate Limits

POST /api/v1/video60 req/min por IP
GET /api/v1/video/{jobId}120 req/min por IP
GET /api/v1/jobs60 req/min por IP
GET /api/ranking/weeklySem limite (cache 5 min)

Ao exceder o limite, a resposta terá status 429 com header Retry-After.

Endpoints

Envia uma URL de vídeo para processamento. A IA detecta os melhores momentos virais e gera cortes prontos para redes sociais. O processamento é assíncrono — use o `jobId` retornado para consultar o status.

🔑 Requer header x-api-key: gz_live_... — apenas usuários Premium

Body (JSON)

videoUrlstring (obrigatório) — URL pública do vídeo (YouTube, Drive, mp4 direto)
settings
format"9:16" | "1:1" | "16:9" (padrão: "9:16")
maxClipsnumber — máximo de cortes a gerar (padrão: 5, máx: 20)
minScorenumber — score viral mínimo 0-100 (padrão: 60)
addSubtitlesboolean — legendas automáticas (padrão: true)
language"pt" | "en" | "es" (padrão: "pt")

Exemplo de código

curl
curl -X POST https://genzmakers.com.br/api/v1/video \
  -H "Content-Type: application/json" \
  -H "x-api-key: gz_live_SUA_CHAVE" \
  -d '{
    "videoUrl": "https://youtube.com/watch?v=abc123",
    "settings": {
      "format": "9:16",
      "maxClips": 5,
      "addSubtitles": true
    }
  }'

Pronto para integrar?

Dúvidas? admin@genzmakers.com.br