Crie nomes padronizados para arquivos de vídeo
Este gerador transforma quatro identificadores de produção em um nome de arquivo previsível.
Executar grátis
Informe o código do projeto, a cena, a tomada e a data de produção para receber um nome MOV padronizado, como KTC_SC12A_T03_20260725.mov. O resultado é determinístico, fácil de ordenar e adequado a originais de câmera, entregas de edição, exportações para aprovação ou manifestos de arquivo. Todos os campos são obrigatórios; dados incompletos geram um erro claro, não um arquivo ambíguo.
Defina um padrão de produção legível
Uma convenção útil permite identificar o clipe antes de abri-lo. O gerador usa PROJECT_SCENE_TAKE_DATE.mov e separa os componentes principais com sublinhados. O código do projeto vem primeiro para reunir seus arquivos em listagens comuns. Em seguida aparecem a cena com o prefixo SC e a tomada com o prefixo T, preenchida até pelo menos dois dígitos. A data fica no final no formato compacto YYYYMMDD, que preserva a ordem cronológica sem pontuação inconveniente. Assim, projeto KTC, cena 12A, tomada 3 e data 2026-07-25 formam KTC_SC12A_T03_20260725.mov. O padrão não inventa informações de câmera, rolo, unidade, versão ou codec. Use o resultado como base confiável e acrescente campos próprios somente em um fluxo documentado cujo significado seja compreendido por toda a equipe.
Entenda a normalização e a validação
Anotações de produção frequentemente misturam maiúsculas, espaços e prefixos. O gerador converte projeto e cena em maiúsculas, remove sinais diacríticos, troca pontuação incompatível por hífens e elimina hífens externos. Portanto, 12A, sc12a e SC-12A resultam em SC12A. A tomada pode ser 3, 03, T3 ou T-03; no fim, deve representar um inteiro positivo e sai como T03. Números maiores permanecem intactos. A data segue um contrato mais rígido: precisa usar YYYY-MM-DD e representar uma data real do calendário gregoriano. Um valor impossível como 2026-02-30 é recusado. Também são rejeitados textos vazios, propriedades ausentes, tomadas zero ou negativas e rótulos não numéricos. Essas regras estabilizam chamadas repetidas e evitam que nomes aparentemente válidos ocultem dados de claquete incompletos.
Use o nome no set, na pós-produção e no arquivo
O gerador funciona melhor onde metadados viram arquivo: ingestão de cartão, relatório de checksum DIT, transcodificação editorial, exportação para revisão ou manifesto. Execute-o antes de gravar ou renomear a mídia, enquanto ainda é possível corrigir os dados da claquete. Guarde os quatro campos normalizados com o nome se outro sistema precisar filtrar ou gerar relatórios. Como o algoritmo não consulta rede, valores aleatórios nem horário atual, a mesma entrada sempre gera o mesmo resultado no navegador e na API. Repetir uma ingestão não cria outro nome. A extensão é MOV por ser um contêiner de produção comum, mas a ferramenta não converte a mídia nem inspeciona o codec. Confirme o uso de .mov, preserve o original quando exigido e trate a nomenclatura como parte de um fluxo que também inclua checksums, backups e responsabilidades documentadas.
Casos de uso
Padronizar a ingestão de cartões
Gere nomes previsíveis enquanto o operador informa a claquete durante a ingestão no set.
Nomear transcodificações editoriais
Aplique a mesma estrutura de projeto, cena, tomada e data aos proxies preparados para edição.
Preparar manifestos de arquivo
Crie nomes ordenáveis e retenha identificadores normalizados para catálogos duradouros.
Perguntas frequentes
Quanto custa uma solicitação?
Cada solicitação à API custa US$ 0,002. A mesma lógica determinística também pode ser executada no navegador.
Qual padrão de nome é usado?
O padrão é PROJECT_SCENE_TAKE_YYYYMMDD.mov, com os prefixos SC e T; por exemplo, KTC_SC12A_T03_20260725.mov.
Posso omitir algum campo?
Não. Projeto, cena, tomada e data são obrigatórios; um valor vazio ou ausente produz erro de entrada.
Como devo formatar a data?
Informe uma data real em YYYY-MM-DD. O nome do arquivo contém a mesma data sem hífens.
A ferramenta renomeia ou converte meu vídeo?
Não. Ela devolve o nome padronizado e os metadados; não acessa, renomeia, inspeciona nem converte a mídia.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/video2/file-naming-convention-build \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"project_code":"KTC","scene":"12A","take":"3","date":"2026-07-25"}'const res = await fetch("https://api.kit.forhosting.com/video2/file-naming-convention-build", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"project_code": "KTC",
"scene": "12A",
"take": "3",
"date": "2026-07-25"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video2/file-naming-convention-build",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"project_code": "KTC",
"scene": "12A",
"take": "3",
"date": "2026-07-25"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video2/file-naming-convention-build", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"project_code":"KTC","scene":"12A","take":"3","date":"2026-07-25"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"project_code":"KTC","scene":"12A","take":"3","date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video2/file-naming-convention-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"project_code": "KTC",
"scene": "12A",
"take": "3",
"date": "2026-07-25"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video2.file_naming_convention_build",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 500 |
max_minutes | 60 |
max_megapixels | 3.9 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |