Introdução

March 10, 2026

Introdução

A API WayinVideo permite que qualquer pessoa integre o processamento de vídeo com IA em seus fluxos de automação. Desenvolvida para processar vídeos de qualquer duração de forma rápida, confiável e eficiente — inclusive vídeos de várias horas — é ideal para pipelines de conteúdo de podcasts, lives de games, webinars, tutoriais, cursos online, entrevistas, reuniões, vlogs, vídeos de e-commerce, demonstrações de produtos e muito mais. Envie uma URL de vídeo ou um arquivo enviado e receba clipes gerados por IA, resumos, transcrições e outros resultados.

Principais Funcionalidades

  • Clipping com IA: Envie um vídeo de qualquer duração e receba todos os clipes classificados por potencial viral, com timestamps de início/fim detectados automaticamente, títulos, descrições e hashtags gerados por IA. Opcional: exporte os vídeos dos clipes renderizados.
  • Buscar Momentos: Descreva os momentos que deseja em linguagem natural — como "momentos engraçados" ou "gols emocionantes" — e a API encontra e extrai clipes correspondentes com timestamps, títulos e descrições de vídeos de qualquer duração. Opcional: exporte os vídeos dos clipes renderizados.
  • Resumo de Vídeo: Gere uma visão geral estruturada, hashtags e destaques da linha do tempo de vídeos de qualquer duração, incluindo conteúdos longos de horas, com processamento rápido e estável.
  • Transcrição de Vídeo: Extraia transcrições com identificação de locutor de conteúdo de vídeo ou áudio.

Fontes de Vídeo Suportadas

A API aceita URLs das seguintes plataformas:

  • YouTube
  • Vimeo
  • Dailymotion
  • Kick
  • Rumble
  • Zoom
  • Twitch
  • TikTok
  • Facebook

Mais plataformas serão adicionadas em breve.

Você também pode usar arquivos enviados localmente. Consulte a API de Upload para mais detalhes.

URL Base

Todas as requisições da API são feitas para:

https://wayinvideo-api.wayin.ai/api/v2

Formato das Requisições

A API é RESTful e aceita corpos de requisição em formato JSON. Todas as requisições devem incluir os seguintes headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2

Formato das Respostas

Sucesso (HTTP 200)

Quando a requisição é bem-sucedida, a API retorna o status HTTP 200 e um corpo JSON contendo apenas o payload em data:

{
  "data": {
    "project_id": "prj06928fdjqqaza",
    "name": "Sample project name",
    "status": "SUCCEEDED"
  }
}

A estrutura de data varia por endpoint; consulte a documentação de cada API para mais detalhes. Para respostas de erro e outros códigos de status HTTP, consulte Códigos de Status.

Ciclo de Vida do Status

Muitos endpoints retornam um status de processamento assíncrono. O ciclo de vida é:

CREATED → QUEUED → ONGOING → SUCCEEDED / FAILED

Use polling para verificar o status até que ele chegue a SUCCEEDED ou FAILED. Quando uma tarefa falha, o campo error_message em data descreve o motivo.