video-enhancement - Aprimoramento de Vídeo por IA
Melhore a qualidade do vídeo usando IA. Aumente a resolução, reduza ruídos, nitidez e aprimore vídeos de baixa qualidade.
Casos de Uso
- Vídeos Antigos: Restaure e aprimore vídeos antigos ou de baixa resolução
- Criação de Conteúdo: Aumente a resolução de vídeos para publicação de maior qualidade
- Vigilância: Melhore a clareza de imagens de câmeras de segurança
- Redes Sociais: Aprimore a qualidade do vídeo antes de publicar
Você é um assistente de linha de comando para aprimoramento de vídeo por IA. Os usuários podem usá-lo para chamar a funcionalidade de aprimoramento de vídeo por IA da verging.ai.
Formato de Entrada do Usuário
Os usuários fornecerão comandos como:
/video-enhancement --video <arquivo de vídeo ou URL> [opções]
Opções
| Opção | Abreviação | Descrição | Padrão |
|---|---|---|---|
| --video | -v | Caminho do arquivo de vídeo alvo ou URL | Obrigatório |
| --hd | -h | Modo HD (aprimoramento de maior qualidade) | false |
| --start | -ss | Tempo de início em segundos | 0 |
| --end | -e | Tempo de fim em segundos | Duração do vídeo |
| --api-key | -k | Sua chave de API | Variável de ambiente VERGING_API_KEY |
| --output | -o | Caminho para salvar o resultado | Diretório atual |
| --download | -d | Baixar automaticamente o resultado para o local | false |
Variáveis de Ambiente
| Variável | Descrição |
|---|---|
| VERGING_API_KEY | Sua chave de API |
| VERGING_API_URL | URL base da API (padrão: https://verging.ai/api/v1) |
Endpoints da API
| Endpoint | Método | Formato | Propósito |
|---|---|---|---|
| /api/v1/auth/me | GET | - | Obter informações do usuário (incluindo créditos) |
| /api/v1/upload-video | POST | Form Data | Obter URL de upload pré-assinado do R2 |
| /api/v1/video_enhance/create-job | POST | Form Data | Criar job de aprimoramento de vídeo |
| /api/v1/jobs/list-jobs | GET | - | Consultar status do job (usar parâmetro job_ids) |
Autenticação
Todas as requisições à API exigem autenticação via cabeçalho Authorization:
Authorization: ApiKey <sua_chave_api>
⚠️ Importante: Há um espaço entre "ApiKey" e sua chave!
Exemplo:
# ✅ Correto
Authorization: ApiKey vrg_sk_123456...
# ❌ Errado (sem espaço)
Authorization: ApiKeyvrg_sk_123456...
Você pode obter sua chave de API em https://verging.ai (Faça login → Clique no avatar → Chaves de API).
Exemplos de Autenticação
# Verificar informações do usuário
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
# Etapa 1: Obter URL de upload pré-assinado para o vídeo
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "video_file_name=video.mp4" \
-F "job_type=video-enhancement" \
https://verging.ai/api/v1/upload-video
# A resposta contém:
# {
# "result": {
# "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
# "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
# }
# }
# Etapa 2: Fazer upload do arquivo de vídeo para a URL pré-assinada
curl -X PUT -T /caminho/para/video.mp4 \
"https://...url-pre-assinada-da-etapa-1..."
# Etapa 3: Criar job de aprimoramento de vídeo
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "target_video_url=https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4" \
-F "file_name=video.mp4" \
-F "user_video_duration=10" \
-F "job_type=video-enhance" \
-F "is_hd=false" \
https://verging.ai/api/v1/video_enhance/create-job
# Consultar status do job
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"
# Listar todos os jobs
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/jobs/list-jobs
Importante:
- Substitua
$VERGING_API_KEYpela sua chave de API real ou defina-a como variável de ambiente - O cabeçalho
Authorizationusa o formato:ApiKey <chave>(nãoBearer <chave>)
Dependências
Esta skill requer:
- Capacidade de download de vídeo remoto (apenas quando o usuário fornecer uma URL como YouTube, Bilibili, etc.):
- Preferido: instale primeiro a skill yt-dlp:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Alternativa:
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader - Alternativa: use
yt-dlpdiretamente se já estiver disponível no sistema - Se nenhuma ferramenta de download estiver disponível, peça ao usuário para baixar o vídeo localmente primeiro
- Preferido: instale primeiro a skill yt-dlp:
- ffmpeg/ffprobe: Para corte de vídeo (opcional, apenas quando --start ou --end for especificado)
- curl: Geralmente já embutido
Fluxo de Processamento
Quando o usuário executar o comando /video-enhancement, siga estas etapas:
0. Verificar Dependências
- Se o usuário fornecer uma URL de vídeo remota, verifique se o
yt-dlpestá disponível:which yt-dlp - Para vídeos locais sem corte, nenhuma ferramenta adicional é necessária
1. Analisar Argumentos
- Analisar o parâmetro --video
- Se for URL remota, precisa baixar para o local
- Analisar --scale (padrão 2x)
- Analisar intervalo de tempo --start e --end
2. Baixar Recursos Remotos
- Se o usuário fornecer uma URL de vídeo remota (YouTube, Bilibili, etc.):
- Tente
yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4 - Se yt-dlp não estiver disponível, sugira instalar a skill yt-dlp:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Se a instalação não for possível, peça ao usuário para baixar o vídeo localmente primeiro
- Tente
- Diretório temporário: /tmp/verging-video-enhancement/
3. Obter Duração do Vídeo
- Use ffprobe:
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"
4. Cortar Vídeo (se --start ou --end especificado)
- Se o usuário especificar os parâmetros --start ou --end, primeiro corte o vídeo
- Use ffmpeg para cortar o intervalo de tempo especificado:
ffmpeg -i input.mp4 -ss <inicio> -to <fim> -c copy output.mp4 - Ou recodifique para quadros precisos:
ffmpeg -i input.mp4 -ss <inicio> -to <fim> -c:v libx264 -c:a aac output.mp4 - Use o vídeo cortado como o arquivo a ser enviado
5. Verificar Créditos do Usuário
- Chame /api/v1/auth/me para obter informações do usuário
- Calcule os créditos necessários com base na duração do vídeo e no modo
- Modo normal: 1 crédito/segundo
- Modo HD: 3 créditos/segundo
- Se os créditos forem insuficientes, peça ao usuário para recarregar
6. Enviar Vídeo para o R2
- Chame
/api/v1/upload-videocom Form Data (video_file_name,job_type=video-enhance) - Obtenha a URL de upload pré-assinada da resposta
- Envie o arquivo de vídeo para a URL pré-assinada usando o método PUT
- Salve a
public_urlda resposta para a próxima etapa
7. Criar Job
- Chame
/api/v1/video_enhance/create-jobcom Form Data:target_video_url: A URL pública do vídeo da etapa 6file_name: Nome do arquivo originaluser_video_duration: Duração do vídeo em segundosjob_type: "video-enhance"is_hd: true/false (modo HD para maior qualidade)
8. Consultar Status do Job
- A cada 5 segundos, chame
/api/v1/jobs/list-jobs?job_ids=xxxpara consultar o status - Status: PENDING → PROCESSING → COMPLETED/FAILED
- Mostre a porcentagem de progresso
9. Retornar Resultado
- Após a conclusão, retorne result_url
- Se o usuário especificou --download ou --output, use curl para baixar o resultado
Consumo de Créditos
| Modo | Créditos/segundo |
|---|---|
| Normal | 1 crédito/segundo |
| HD | 3 créditos/segundo |
Formatos de Vídeo Suportados
- MP4
- MOV
- AVI
- MKV
- WebM
Duração máxima do vídeo: 30 segundos Tamanho máximo do arquivo: 500MB
Exemplo de Conversa
Usuário: /video-enhancement -v ./old-video.mp4
Você:
- Analisar argumentos - vídeo local, modo normal
- Obter duração do vídeo
- Chamar API para obter informações do usuário
- Verificar créditos suficientes (duração × 1 crédito/segundo)
- Enviar vídeo para o R2
- Criar job de aprimoramento de vídeo
- Consultar até a conclusão
- Retornar URL do resultado
Usuário: /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15
Você:
- Analisar argumentos - vídeo remoto, modo HD, cortar 5-15s
- Baixar vídeo usando yt-dlp
- Cortar vídeo para 10 segundos
- Obter duração do vídeo cortado
- Verificar créditos suficientes (10 s × 3 créditos/s = 30 créditos)
- Enviar vídeo cortado para o R2
- Criar job de aprimoramento de vídeo com is_hd=true
- Consultar até a conclusão
- Retornar URL do resultado
Notas
- Esta skill usa yt-dlp para downloads de vídeos remotos (YouTube, Bilibili, etc.)
- Para vídeos locais sem corte, nenhuma ferramenta adicional é necessária
- A chave de API pode ser passada via parâmetro --api-key ou lida da variável de ambiente VERGING_API_KEY
- Se o usuário não fornecer a chave de API: Peça para obter uma em https://verging.ai (Faça login → Clique no avatar do usuário → Chaves de API) e oriente a definir a variável de ambiente
- Duração máxima do vídeo: 30 segundos
- Suporta download de vídeos do YouTube, Bilibili, etc. usando yt-dlp
- Mostre o progresso durante o processamento
- Se --start ou --end for especificado, o vídeo será cortado localmente antes do upload, economizando tempo de upload e custo de processamento
Privacidade e Segurança
Chave de API
Esta skill requer uma chave de API da verging.ai. Obtenha-a em:
- Visite https://verging.ai
- Faça login → Clique no avatar do usuário (canto superior direito) → Selecione "Chaves de API"
- Crie uma nova chave de API
Recomendações de segurança:
- Use uma chave de API dedicada com permissões mínimas
- Nunca exponha sua chave de API em repositórios públicos
- Defina-a via variável de ambiente:
export VERGING_API_KEY="sua_chave"
Manipulação de Dados
- Uploads de vídeo: Os vídeos são enviados para o armazenamento R2 da verging.ai para processamento
- Arquivos temporários: Os arquivos temporários locais são armazenados em
/tmp/verging-video-enhancement/e limpos após o processamento - Vídeos resultantes: Os vídeos processados são retornados via uma URL pública
- Sem retenção de dados: Esta skill não armazena nenhum dado do usuário além da sessão
Aviso Legal
- Processe apenas mídia que você tem direitos
- Use de forma responsável e ética