Builtin Templates: transformações estáveis e versionadas

Kevin van Zonneveld

Cofundador · Amsterdã, Países Baixos · Mostrar biografia

Às vezes, você quer começar a partir de um Template sólido e bem testado em vez de criar um do zero. Hoje, estamos anunciando os Builtin Templates: Templates mantidos e versionados pela Transloadit, que você pode referenciar por template_id como qualquer outro Template.

Os Builtin Templates foram criados para transformações comuns e blocos de construção rápidos. Eles são estáveis, são versionados, e você pode fixar uma versão específica quando precisar de um deploy com controle de mudanças.

O que são Builtin Templates?

Os Builtin Templates ficam dentro da API2 e são identificados por slugs que começam com builtin/, por exemplo:

• builtin/encode-hls-video@0.0.1
• builtin/generate-image@0.0.1
• builtin/generate-video@0.0.1

Você pode usá-los via template_id:

• builtin/<name> aponta para a versão conhecida mais recente.
• builtin/<name>@latest é um alias explícito para a versão conhecida mais recente.
• builtin/<name>@<version> fixa uma versão específica.

Por que usar Builtin Templates?

• Comece a partir de uma base consolidada e comprovadamente boa para transformações comuns.
• Mantenha sua integração enxuta: não é preciso criar um Template só para testar algo.
• Fixe versões para ter um comportamento previsível e atualize quando estiver pronto.
• Combine o Builtin Template com seus próprios Steps sobrescrevendo-o em tempo de execução, como com qualquer outro Template.

Exemplo rápido: criar uma Assembly usando um Builtin Template

Veja o formato de uma requisição de Assembly usando um Builtin Template:

{
  "template_id": "builtin/encode-hls-video"
}

Você ainda pode sobrescrever ou estender Steps em tempo de execução (por exemplo, para adicionar um Step de exportação para armazenamento), da mesma forma que faria com qualquer Template. Para mais informações sobre como sobrescrever, consulte Templates.

Veja o que está disponível

Mantemos a lista canônica e as notas de uso na documentação:

• Builtin Templates

Se você quiser que eles apareçam nas listagens da API, pode incluí-los em GET /templates com include_builtin (consulte a referência do endpoint para mais detalhes):

• Recuperar a lista de Templates

O que vem a seguir

Os Builtin Templates ainda são uma área pequena, e vamos expandi-los com base no uso real. Se você tem uma transformação que executa repetidamente e acha que ela deveria virar um Builtin Template, fale com a gente.

Se você ainda não usa Templates, comece por eles:

• Templates