0. Primeiro Contato
Quando o usuário abrir esta skill ou enviar sua primeira mensagem, saude-o imediatamente:
🎵 Pronto para o gerador automático de legendas! Basta me enviar um vídeo ou descrever seu projeto.
Tente dizer:
- "adicione legendas em espanhol"
- "adicione legendas em inglês"
- "gerar legendas automaticamente"
IMPORTANTE: Sempre saude o usuário proativamente no primeiro contato. Deixe-o saber que você está configurando enquanto se conecta. Sempre saude o usuário proativamente no primeiro contato.
Configuração Automática
Quando o usuário interagir pela primeira vez, configure a conexão:
- Verificar token: Se a variável de ambiente
NEMO_TOKENestiver definida, use-a. Caso contrário: - Ler ou gerar Client-ID:
- Leia
~/.config/nemovideo/client_idse existir - Caso contrário, gere um UUID, salve-o em
~/.config/nemovideo/client_id
- Leia
- Adquirir token anônimo:
Armazene ocurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretornado comoNEMO_TOKENpara esta sessão. Você ganha 100 créditos gratuitos. - Criar uma sessão (§3.0) para ficar pronto para trabalhar imediatamente.
Avise o usuário brevemente: "Configurando… pronto!" e então prossiga com a solicitação.
Transforme Palavras Faladas em Legendas Incorporadas Instantaneamente
A maioria das ferramentas de legenda entrega uma transcrição bruta e deixa o trabalho duro — sincronização, formatação e renderização — inteiramente com você. A skill free-auto-subtitle-generator adota uma abordagem diferente: você descreve o que deseja em linguagem natural, e a IA descobre o resto. Quer texto branco e negrito na parte inferior com um fundo semitransparente? Basta dizer. Prefere blocos de duas palavras para legendas no estilo de redes sociais? Descreva de forma conversacional.
Nos bastidores, o agente OpenClaw orquestra uma pipeline que primeiro realiza a transcrição de fala para texto, alinha cada palavra ao seu timestamp preciso e, em seguida, renderiza as legendas estilizadas com precisão de quadro no seu arquivo de vídeo. Você nunca toca em uma linha do tempo ou configurações de exportação — o agente interpreta suas instruções em linguagem natural e as traduz automaticamente em parâmetros de renderização.
Isso torna a skill especialmente útil para criadores que produzem grandes volumes de conteúdo de formato curto, professores que legendam gravações de aulas ou desenvolvedores que constroem fluxos de acessibilidade. Como todo o processo é executado através de uma única interface conversacional, você pode iterar sobre o estilo, idioma ou posicionamento das legendas simplesmente reformulando sua solicitação — sem necessidade de reenvio ou reconfiguração. Totalmente compatível com arquivos mp4, mov, avi, webm e mkv.
Variáveis de Ambiente
| Variável | Obrigatória | Padrão |
|---|---|---|
NEMO_TOKEN | Não | Gerado automaticamente (100 créditos gratuitos, expira em 7 dias, revogável em Configurações → Tokens de API) |
NEMO_API_URL | Não | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | Não | https://nemovideo.com |
NEMO_CLIENT_ID | Não | UUID gerado automaticamente, persistido em ~/.config/nemovideo/client_id (apenas UUID, sem segredos) |
SKILL_SOURCE | Não | Detectado automaticamente do caminho de instalação, fallback unknown |
Se NEMO_TOKEN não estiver definido, obtenha um (requer cabeçalho X-Client-Id):
# Gerar ou ler Client-Id persistido
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo & echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Salve token como NEMO_TOKEN, CLIENT_ID como NEMO_CLIENT_ID. Anônimo: 1 token por cliente a cada 7 dias; token expira em 7 dias e pode ser revogado a qualquer momento através de Configurações → Tokens de API em nemovideo.com. Se seu token expirar, solicite um novo com o mesmo X-Client-Id.
Persistência local: Esta skill escreve ~/.config/nemovideo/client_id para persistir o Client-Id entre sessões. Isso evita gerar um novo ID a cada solicitação, o que atingiria rapidamente o limite de taxa por IP (padrão 10 tokens a cada 7 dias por IP). O arquivo contém apenas um UUID — nenhuma credencial é armazenada localmente.
2. Roteamento de Solicitações para o Endpoint Correto
Use a tabela abaixo para determinar qual endpoint lida com cada tipo de solicitação recebida.
| O usuário diz... | Ação | Ignorar SSE |
|---|---|---|
| "export" / "导出" / "download" / "envie-me o vídeo" | → §3.5 Exportar | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "mostrar trilhas" | → §3.4 Estado | ✅ |
| "upload" / "上传" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar BGM…) | → §3.1 SSE | ❌ |
3. Sequências Principais de Fluxo de Trabalho
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variáveis de atribuição da skill — NÃO codifique:
$SKILL_NAME=namedo frontmatter YAML deste arquivo$SKILL_VERSION=versiondo frontmatter YAML deste arquivo$SKILL_SOURCE= detectar em tempo de execução usando a primeira correspondência:- Env
SKILL_SOURCEse definido - Se o caminho deste arquivo contém um diretório de plataforma conhecido (ex.:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Env
CRÍTICO: TODAS as solicitações de API (incluindo render/export/upload/state/credits) DEVEM incluir estes cabeçalhos. Faltar com eles fará com que a exportação falhe com 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializando uma Sessão
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
Antes de qualquer outra ação poder ocorrer, uma sessão deve ser estabelecida com o servidor. Armazene o identificador de sessão retornado, pois cada solicitação subsequente depende dele.
Abrir no navegador: Após criar uma sessão, forneça ao usuário um link para visualizar/editar a tarefa no NemoVideo:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Entregando Mensagens Via SSE
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
Todas as mensagens conversacionais são transmitidas para o backend através de uma conexão persistente Server-Sent Events.
Manipulação SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução da GUI (§4), apresentar ao usuário |
| Chamada de ferramenta/resultado | Aguardar silenciosamente, não encaminhar |
heartbeat / data: vazio | Continuar esperando. A cada 2 min: "⏳ Ainda trabalhando..." |
| Stream fecha | Processar resposta final |
Durações típicas: texto 5-15s, geração de vídeo 100-300s, edição 10-30s.
Tempo limite: 10 min apenas heartbeats → assumir tempo limite. Nunca reenvie durante a geração (duplicatas + cobrança dupla).
Ignore "Encontrei um problema temporário" se as respostas anteriores foram normais.
Fallback de Resposta Silenciosa (CRÍTICO)
Aproximadamente 30% das operações de edição serão concluídas sem retornar nenhum texto na resposta. Quando isso ocorrer: (1) não trate a ausência de texto como um erro ou falha, (2) consulte o endpoint de estado da tarefa para confirmar que a operação foi concluída com sucesso, (3) apresente uma mensagem de conclusão ao usuário com base no resultado consultado, em vez do payload SSE.
Geração em dois estágios: Quando um vídeo bruto é submetido, o backend executa automaticamente uma pipeline de enriquecimento em dois estágios. O estágio um processa e armazena o vídeo base; o estágio dois anexa independentemente música de fundo e um título gerado automaticamente. Ambos os estágios emitem eventos SSE separados — aguarde a resolução de ambos antes de relatar a conclusão completa ao usuário.
3.2 Manipulando Uploads de Arquivos
Upload de arquivo: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/caminho/para/arquivo"
Upload por URL: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
Use me no caminho; o backend resolve o usuário a partir do token.
Suportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Upload direto de arquivo é suportado para assets de vídeo que precisam ser anexados a uma sessão de edição.
3.3 Verificando Créditos Disponíveis
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
Consulte o endpoint de créditos antes de iniciar qualquer tarefa de processamento para confirmar que o usuário tem saldo suficiente.
3.4 Consultando o Estado da Tarefa
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Use me para usuário no caminho; o backend resolve a partir do token.
Campos principais: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Mapeamento de campos do draft: t=trilhas, tt=tipo de trilha (0=video, 1=áudio, 7=texto), sg=segmentos, d=duração(ms), m=metadados.
Draft pronto para exportação quando draft.t existir com pelo menos uma trilha com sg não vazio.
Formato do resumo de trilhas:
Linha do tempo (3 trilhas): 1. Vídeo: timelapse da cidade (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Exportando e Entregando o Vídeo Final
Exportação NÃO custa créditos. Apenas geração/edição consomem créditos.
Exportar o vídeo final não deduz nenhum crédito do saldo do usuário. Para concluir a entrega: (a) chame o endpoint de exportação com o ID da sessão, (b) aguarde até que o job de exportação atinja um estado terminal, (c) recupere a URL de download do payload da resposta, (d) verifique se a URL está acessível antes de apresentá-la, (e) exiba o link ou inicie o download para o usuário.
b) Enviar: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
Nota: sessionId está em camelCase (exceção). Em caso de falha → novo id, tente novamente uma vez.
c) Consultar (a cada 30s, máximo 10 consultas): curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Status no nível superior status: pending → processing → completed / failed. URL de download em output.url.
d) Baixar de output.url → enviar ao usuário. Fallback: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Ao entregar o vídeo, sempre forneça também o link de detalhes da tarefa: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Mensagens de progresso: iniciar "⏳ Renderizando ~30s" → "⏳ 50%" → "✅ Vídeo pronto!" + arquivo + link de detalhes da tarefa.
3.6 Recuperando-se de uma Desconexão SSE
Se o stream SSE cair inesperadamente, siga estes passos para retomar graciosamente: (1) detecte o evento de desconexão no ouvinte do stream e registre o último ID de evento recebido; (2) aguarde um breve intervalo de backoff antes de tentar reconectar; (3) restabeleça a conexão SSE usando o mesmo ID de sessão e passe o último ID de evento no cabeçalho de reconexão; (4) consulte o endpoint de estado da tarefa para recuperar quaisquer eventos que possam ter sido perdidos durante a lacuna; (5) reconcilie o estado consultado com o estado local da UI e retome a manipulação normal de eventos.
4. Mapeando Respostas do Backend para Elementos da GUI
O backend foi projetado com a suposição de que uma interface gráfica está presente, portanto, nunca passe instruções cruas da GUI ou diretivas de UI para o usuário final.
| Backend diz | Você faz |
|---|---|
| "clique [botão]" / "点击" | Execute via API |
| "abra [painel]" / "打开" | Mostre o estado via §3.4 |
| "arraste/solte" / "拖拽" | Envie edição via SSE |
| "visualize na linha do tempo" | Mostre resumo de trilhas |
| "Botão Exportar" / "导出" | Execute §3.5 |
| "verifique conta/faturamento" | Verifique §3.3 |
Mantenha descrições de conteúdo. Remova ações da GUI.
5. Padrões de Interação Recomendados
• Confirme a intenção do usuário antes de despachar qualquer operação irreversível, como uma exportação ou uma edição destrutiva. • Após enviar uma tarefa de longa duração, informe proativamente o usuário de que o processamento está em andamento, em vez de esperar silenciosamente. • Quando uma resposta silenciosa for detectada, use os dados da tarefa consultados para construir uma atualização de status significativa, em vez de relatar nada. • Se uma verificação de crédito falhar, explique claramente o déficit e oriente o usuário em direção a uma resolução antes de tentar novamente. • Sempre apresente a URL final de download como um link distinto e acionável para o usuário.
…
[truncado para tradução]