# Início Rápido

> Comece a usar a API WayinVideo em minutos.

## Início Rápido

Siga estes passos para começar a usar a API WayinVideo em minutos.

## 1. Obtenha sua Chave de API

1. Faça login no seu [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard)
2. Clique em **Create API Key** para gerar uma nova chave
3. Copie e guarde sua chave de API com segurança

> **Importante:** Mantenha sua chave de API em segredo. Não a exponha em código do lado do cliente ou repositórios públicos.

## 2. Envie uma Tarefa de Clipping

Envie uma URL de vídeo para iniciar uma tarefa de clipping com IA:

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": false
  }'
```

Resposta:

```json
{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "CREATED"
  }
}
```

## 3. Consulte os Resultados

Consulte o status da tarefa até que ele chegue a `SUCCEEDED`. Recomendamos consultar a cada **30 segundos**.

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/results/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

Quando concluído, a resposta inclui seus clipes:

```json
{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": "15000",
        "end_ms": "75000",
        "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
        "tags": ["insight", "analysis"],
        "desc": "sample description"
      }
    ]
  }
}
```

> **Nota:** Ao enviar uma tarefa de Clipping, você pode definir `enable_export = true` para que o serviço renderize e exporte o vídeo com links de download. Como a renderização requer tempo de processamento adicional, a conclusão levará mais tempo do que quando a exportação está desativada.

## 4. Exporte e Publique Clipes

Depois que os clipes forem gerados, você pode renderizá-los como arquivos de vídeo ou publicá-los diretamente em contas de redes sociais conectadas:

- [API de Exportação de Clipes](https://wayin.ai/pt/api-docs/clips-export/) — Renderize ou reexporte clipes com resolução, legendas, AI Reframe, AI Hook e outras configurações personalizadas.
- [API de 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.

## Próximos Passos

- [Clipping com IA](https://wayin.ai/pt/api-docs/ai-clipping/) — Obtenha clipes virais de vídeos longos
- [Buscar Momentos](https://wayin.ai/pt/api-docs/find-moments/) — Encontre momentos usando consultas em linguagem natural
- [Resumo de Vídeo](https://wayin.ai/pt/api-docs/video-summarization/) — Obtenha visões gerais e destaques da linha do tempo
- [Notas de Vídeo](https://wayin.ai/pt/api-docs/video-notes/) — Gere notas estruturadas com IA nos formatos Markdown e texto simples
- [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
- [AI for Stream Videos](https://wayin.ai/solutions/stream) — Explore Live Stream Understanding and Clipping para fluxos de vídeo em tempo real.