FrameOracle

Quickstart

Primeira análise em 5 minutos — copy-paste e funciona.

1. Cria tua conta

Vai em /signup e cria uma conta com email/senha ou Google. Verifica teu email (caixa de entrada → clica no link). Sem custo, sem cartão.

2. Cadastra teu primeiro produto

No /dashboard/products/new preenche:

  • Nome — identificador do produto (ex. ViralCutter)
  • Dimensões — quais features queres consumir. Recomendo começar com audio, scenes, ocr.
  • Budget mensal — limite em BRL pra evitar surpresa.
  • Rate limit — req/min. 60 cobre uso típico.

Submit → tu vê uma única vez a API key completa (vap_xxx…). Copia agora — se perder, tens que rotacionar.

3. Confirma que o backend tá vivo

Endpoint público, não precisa autenticação:

curl https://video-analysis-hu5ixjipbq-rj.a.run.app/v1/health
# {"status":"ok","schema_version":"1.0.0"}

4. Tua primeira análise

Substitui vap_TUA_KEY_AQUI pela key que copiaste no passo 2:

curl -X POST https://video-analysis-hu5ixjipbq-rj.a.run.app/v1/analyze \
  -H "x-api-key: vap_TUA_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://exemplo.com/video.mp4",
    "dimensions": ["audio", "scenes", "ocr"]
  }'

Resposta esperada (job criado):

{
  "job_id": "job_abc123…",
  "status": "queued",
  "schema_version": "1.0.0"
}

5. Recupera o resultado

Poll GET /v1/result/{job_id} até status: "completed":

curl https://video-analysis-hu5ixjipbq-rj.a.run.app/v1/result/job_abc123 \
  -H "x-api-key: vap_TUA_KEY_AQUI"

Recomendado: configura um webhook ao criar o produto pra receber notificação em vez de polling. Ver Segurança & webhooks.

Próximos passos

Quickstart — FrameOracle