# Introdução

> Visão geral da API WayinVideo e suas principais funcionalidades.

## 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, filmagens de passeios urbanos, vídeos esportivos, vídeos de e-commerce, demonstrações de produtos e muito mais. Envie uma URL de vídeo ou um arquivo carregado e receba clipes, resumos, notas estruturadas, transcrições, vídeos aprimorados e outros resultados gerados por IA.

## Lista de APIs

- **[Clipping com IA](https://wayin.ai/pt/api-docs/ai-clipping/)**: 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](https://wayin.ai/pt/api-docs/find-moments/)**: 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.
- **[Publicação em Redes Sociais](https://wayin.ai/pt/api-docs/social-media-publishing/)**: Conecte contas de redes sociais e publique clipes gerados por Clipping com IA ou Buscar Momentos em plataformas como YouTube, TikTok, Instagram, Facebook, X / Twitter, LinkedIn e outras.
- **[Resumo de Vídeo](https://wayin.ai/pt/api-docs/video-summarization/)**: 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.
- **[Notas de Vídeo](https://wayin.ai/pt/api-docs/video-notes/)**: Gere notas personalizáveis com IA a partir de vídeos e obtenha o resultado nos formatos Markdown e texto simples, junto com uma visão geral estruturada, hashtags e destaques da linha do tempo.
- **[Transcrição de Vídeo](https://wayin.ai/pt/api-docs/video-transcription/)**: Extraia transcrições em nível de palavra com diarização de locutores de conteúdo de vídeo ou áudio.
- **[Aprimoramento de Vídeo](https://wayin.ai/pt/api-docs/video-enhancer/)**: Aprimore um arquivo de vídeo da plataforma ou um arquivo enviado para 1080p, 2K ou 4K. A nitidez do texto na tela é opcional, e você pode processar o vídeo inteiro ou um trecho de até 10 minutos.
- **[AI for Stream Videos](https://wayin.ai/solutions/stream)**: A IA líder mundial da WayinVideo entende o mundo em tempo real e o explora ativamente ao seu lado, impulsionando Live Stream Understanding and Clipping e servindo como o cérebro para AI Hardware and Robotics. Para solicitar acesso, visite [aqui](https://wayin.ai/solutions/stream/#solution-contact-form) para falar com vendas.

## 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 processar [arquivos de vídeo locais enviados](https://wayin.ai/pt/api-docs/upload/).

## 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`:

```json
{
  "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](https://wayin.ai/pt/api-docs/status-codes/).

## 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.