# Codex

> Instale a Skill WayinVideo no Codex para transformar URLs de vídeo em clipes, resumos, timestamps e conteúdo social pronto para publicação direto do seu coding workspace.

## Integração com Codex

O Codex pode usar a **Skill WayinVideo** como um assistente de workspace para entendimento de vídeo, AI clipping e preparação de conteúdo short-form.

Em vez de alternar entre seu coding environment e uma ferramenta de vídeo separada, você pode pedir ao Codex para executar workflows WayinVideo enquanto trabalha em scripts, pipelines de conteúdo, ferramentas de publicação social ou lógica de automação. A Skill fornece as ações de vídeo; a WayinVideo API realiza o processamento por trás.

Isso é especialmente útil para workflows liderados por desenvolvedores, como:

- criar um script de automação de conteúdo,
- testar um pipeline de YouTube para clipes,
- preparar clipes para um fluxo de publicação em redes sociais,
- extrair timestamps para uma ferramenta editorial,
- transformar uma URL de vídeo em dados estruturados para um app ou CMS.

---

## Visão Geral da Configuração

A configuração tem três partes:

1. Baixe o pacote da Skill WayinVideo no ClawHub.
2. Peça ao Codex para instalar o arquivo ZIP baixado.
3. Forneça sua API key da WayinVideo quando o Codex solicitar.

Antes de executar tarefas de vídeo, confirme que sua conta WayinVideo tem API Units disponíveis. Você pode criar uma API key e comprar API Units no [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard).

> Trate sua API key como um segredo. Não faça commit em repositórios, não cole em logs compartilhados e não exponha em código do lado do cliente.

---

## Instalar no Codex

### 1. Baixe o ZIP da Skill

Abra a página da Skill WayinVideo:

[https://clawhub.ai/wayinvideo/video-understanding-and-ai-clipping](https://clawhub.ai/wayinvideo/video-understanding-and-ai-clipping)

Baixe o pacote para o seu computador. Guarde o caminho do arquivo ZIP, porque o Codex precisará dele durante a instalação.

### 2. Peça ao Codex para Instalar

No Codex, envie um prompt de instalação com o caminho do arquivo baixado:

```text
Please install the WayinVideo skill package located at [the path of downloaded zip file].
```

Por exemplo:

```text
Please install the WayinVideo skill package located at /Users/example/Downloads/wayinvideo-video-understanding-and-ai-clipping.zip.
```

### 3. Conecte sua API Key

Quando a configuração da Skill solicitar credenciais, insira uma API key da WayinVideo obtida em:

[https://wayin.ai/wayinvideo/api-dashboard](https://wayin.ai/wayinvideo/api-dashboard)

Se seu saldo de API Units estiver vazio, compre um API Units Package antes de executar a primeira tarefa de vídeo.

### 4. Recarregue o Codex se Necessário

Alguns ambientes Codex podem pedir reload ou restart após a instalação de uma nova Skill. Siga o prompt se ele aparecer e depois inicie uma nova request com `/wayinvideo`.

---

## Primeira Request no Codex

Depois da configuração, experimente uma request curta com uma URL de vídeo clara e um objetivo de saída:

```text
/wayinvideo Generate 6 clip candidates from this YouTube video for TikTok and YouTube Shorts. Include start/end timestamps, a short title, why each clip works, and suggested hashtags: [a youtube video link]
```

Substitua `[a youtube video link]` pela URL do vídeo de origem.

O Codex encaminhará a request pela Skill WayinVideo e retornará as ideias de clipes, timestamps ou saídas geradas conforme seu prompt e as configurações da conta.

---

## Padrões de Prompt para Codex

Use prompts que descrevam o vídeo de origem, o canal de destino e a saída exata que você quer.

### Criar uma Fila de Clipes

```text
/wayinvideo Use AI Clipping on this video and return the strongest short clips. For each clip, include the start time, end time, title, description, and score: https://www.youtube.com/watch?v=example
```

### Extrair Momentos para uma Página de Produto

```text
/wayinvideo Use Find Moments to locate every part where the speaker discusses product benefits or customer objections. Return timestamps and a one-sentence reason for each match: https://www.youtube.com/watch?v=example
```

### Preparar Legendas Sociais

```text
/wayinvideo Clip this video into vertical short-form ideas for social posting. Prioritize moments with a strong hook, clear takeaway, or surprising statement: https://www.youtube.com/watch?v=example
```

### Criar um Resumo para CMS

```text
/wayinvideo Find the best educational moments in this video and summarize each one with its timestamp, topic, and recommended clip title: https://www.youtube.com/watch?v=example
```

---

## Ideias de Workflow para Codex

| Workflow | Como o Codex Pode Usar a Skill |
| -------- | ------------------------------ |
| Automação de conteúdo | Gerar clip metadata que pode ser copiada para scripts, filas ou registros de CMS. |
| Publicação social | Preparar títulos, descrições, hashtags e planos de conteúdo prontos para contas sociais. |
| Revisão editorial | Encontrar timestamps que valem revisão antes de exportar ou publicar clipes. |
| Pesquisa de produto | Localizar momentos em que speakers discutem features, comparações, objeções ou use cases. |
| Documentação | Converter video walkthroughs em resumos, highlights e notas estruturadas. |

---

## Referências Úteis de API

A Skill é a forma mais simples de começar dentro do Codex, mas estas referências de API ajudam quando você quer criar ou depurar um workflow personalizado:

| Necessidade | Documentação da API |
| ----------- | ------------------- |
| Gerar clipes a partir de vídeos longos | [API de Clipping com IA](https://wayin.ai/pt/api-docs/ai-clipping/) |
| Buscar momentos exatos com um prompt | [API Buscar Momentos](https://wayin.ai/pt/api-docs/find-moments/) |
| Criar resumos estruturados e timeline highlights | [API de Resumo de Vídeo](https://wayin.ai/pt/api-docs/video-summarization/) |
| Extrair transcripts com timing e speaker labels | [API de Transcrição de Vídeo](https://wayin.ai/pt/api-docs/video-transcription/) |
| Exportar clipes selecionados com configurações de render | [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/) |
| Publicar clipes em contas sociais conectadas | [API de Publicação em Redes Sociais](https://wayin.ai/pt/api-docs/social-media-publishing/) |
| Revisar API Units e comportamento de cobrança | [Pricing](https://wayin.ai/pt/api-docs/pricing/) |

Para a referência completa da Skill, consulte [Skill de Entendimento de Vídeo e Clipping com IA](https://wayin.ai/pt/api-docs/skills-video-understanding-and-ai-clipping/).

---

## Solução de Problemas

### `/wayinvideo` Não Está Disponível

Confirme que a instalação do ZIP foi concluída com sucesso. Se o Codex pediu reload ou restart, faça isso antes de tentar o comando novamente.

### Codex Solicita a API Key Novamente

Insira a API key atual da WayinVideo no [API Dashboard](https://wayin.ai/wayinvideo/api-dashboard). Se você rotacionou ou excluiu uma key, use a key ativa mais recente.

### Uma Request Falha por Causa de API Units

Verifique seu saldo de API Units no [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard). Adicione um API Units Package antes de enviar outra tarefa de vídeo se o saldo estiver vazio.
