Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
Contribuindo um template de criação (Português)
English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia | Español | Français | Deutsch | Português | Русский | العربية
Um template de criação é uma pasta dentro de template/<módulo>/<id>/<versão>/ com um template.json e seus recursos locais. Os templates alimentam os seletores visuais de geração de imagem, vídeo e capa — os usuários começam a partir do seu preset em vez de um prompt em branco. Este guia mostra como adicionar um.
O que um template de criação É / NÃO É
Um template É:
- Um preset ajustado: prompts padrão, dicas de estilo, configurações de proporção/duração/qualidade, mais capa e prévia que mostram o resultado.
- Autossuficiente. Tudo o que o seletor exibe vive na pasta do template.
Um template NÃO É:
- Um novo tipo de template. Os módulos atuais são
image-generation,video-generationecover-generator. Se você precisa de um módulo novo, abra uma issue para discutir primeiro — isso é uma mudança de produto, não um template. - Um amontoado de prompts. Templates com prompt vazio ou genérico e sem padrões localizados serão devolvidos; o valor está no ajuste fino.
- Trabalho de outras pessoas sem direitos. Veja Atribuição e direitos.
Início rápido
corepack enable && pnpm install
cp -r template/cover-generator/images-go-hard-thumbnail template/<módulo>/<seu-id-de-template>
# edite template.json, substitua os recursos de capa/prévia
pnpm templates:validate # deve passar antes de abrir um PR
IDs de template usam letras minúsculas com hífens e são únicos dentro do módulo. A versão começa em 1 — uma pasta por versão, então atualizações criam <id>/2/ em vez de editar <id>/1/.
Anatomia da pasta
template/<módulo>/<id>/1/
├── template.json # obrigatório: metadados, padrões, conteúdo localizado
├── cover.jpg # obrigatório: exibido no seletor de templates
├── preview.jpg # módulos de imagem/capa: prévia ampliada do resultado
├── previewVideo # módulo de vídeo: clipe de exemplo, ex. example.mp4
└── author-avatar.jpg # opcional: avatar do autor creditado
Campos do template.json
| Campo | Obrigatório | Notas |
|---|---|---|
schemaVersion |
sim | Atualmente 1. |
id, version, module |
sim | Devem corresponder ao caminho <módulo>/<id>/<versão>/. |
runtimeTemplate |
sim | Mapeia para o executor do Runtime, ex. {"id": "cover", "version": 2}. Copie de um template do mesmo módulo. |
status |
sim | published para publicar; use draft enquanto itera. |
title, description |
sim | zh-CN e en-US são obrigatórios. Outros idiomas são opcionais. |
cover |
sim | Caminho relativo para a miniatura do seletor. |
preview / previewVideo |
depende do módulo | preview para imagem e capa, previewVideo para vídeo. |
defaults |
sim | Configurações base de onde o usuário parte (prompt, proporção, duração, qualidade…). |
defaultsByLocale |
fortemente recomendado | Overrides localizados de prompt e estilo por idioma. É aqui que mora o ajuste fino — veja abaixo. |
tags |
recomendado | Rótulos pesquisáveis; mantenha-os factuais. |
author |
se aplicável | name, url, avatar para fontes externas creditadas. |
featured, sortOrder |
não | Deixe featured: false; os mantenedores decidem o destaque. |
O prompt é o produto
Os revisores passam a maior parte do tempo em defaults e defaultsByLocale:
- Ambos os idiomas devem ser prompts reais, não traduções que perderam o ajuste. Os prompts
zh-CNeen-USdevem produzir resultados equivalentes aproveitando os pontos fortes de cada idioma. - Parametrize o que deve mudar. Se o título ou o assunto é editável pelo usuário, diga isso explicitamente no prompt (templates existentes usam marcadores como "Customizable text: …").
- Declare restrições. "Sem marca d'água, sem texto extra, sem pessoas extras" — restrições negativas importam tanto quanto a descrição para resultados reproduzíveis.
- Siga a forma de
defaultsdo módulo. Templates de imagem trazem ratio/candidateCount/quality; de vídeo trazem size/duration; de capa trazem título, idioma do texto e campos de estilo. Copie a forma de um template existente do seu módulo.
Recursos
- Gere o
cover.jpge a prévia com o próprio template — imagem de banco ou arte não relacionada será rejeitada. - Mantenha os tamanhos de arquivo razoáveis; esses arquivos são distribuídos com o app e carregados no seletor.
- A prévia deve representar um resultado típico, não o melhor de cinquenta tentativas.
Atribuição e direitos
Se o seu template adapta um prompt ou estilo publicado por outra pessoa:
- Você precisa ter o direito de redistribuí-lo.
- Preencha o campo
authorcomnameeurl(eauthor-avatar.jpgse disponível), como fazem os templates existentes. - Em caso de dúvida, abra uma issue e pergunte antes de fazer o trabalho.
Critérios de merge
- O caminho da pasta corresponde a
id/version/module; o ID é único no módulo. -
pnpm templates:validatepassa. -
titleedescriptionfornecidos emzh-CNeen-US. -
defaultsByLocalecontém prompts ajustados para ambos os idiomas. - Recursos de capa e prévia foram gerados pelo próprio template.
- Atribuição
authorincluída ao adaptar trabalho externo. -
featured: false,status: "published"(oudraftcom nota no PR).
Padrões comuns de rejeição
- Prompt genérico — o template não adiciona nada sobre um prompt em branco; o seletor não precisa dele.
- Idioma faltando — apenas um idioma ajustado, ou tradução automática que perdeu as restrições de estilo.
- Recursos incompatíveis — a capa não corresponde ao que o prompt realmente gera.
- Direitos incertos — adaptado do trabalho de alguém sem atribuição ou permissão.
- Versão antiga editada no lugar — crie uma pasta de versão nova em vez de reescrever o histórico de
<id>/1/.
Dúvidas? Abra uma issue com sua ideia de template e um exemplo de saída, e ajudaremos a delimitar o escopo.