Docs do Nodaro
DocumentaçãoReferência de nósModelosAgentes de IA (MCP)DesenvolvedoresSelf-hostingPesquisa

Sequência de tomadas

Crie um vídeo de motion graphics narrado em que textos e formas aparecem quando a locução os diz, com um briefing, alinhamento forçado e renderização.

Uma sequência de tomadas é um vídeo de motion graphics narrado em que cada texto na tela, cada forma e cada imagem aparece no momento em que a locução diz a frase correspondente. Você, ou um assistente, escreve um briefing: a narração, as deixas dela e as cenas, tomadas e revelações. O Nodaro alinha a locução gravada palavra por palavra e fixa cada deixa em um quadro exato; assim, o tempo é determinístico. O Diretor de vídeo se apoia nesse pipeline e escreve o briefing para você.

O pipeline

áudioalinhamentoplanogenerate_speechA narraçãoforced_alignmentTempos das palavrasresolve_shot_sequenceDeixas em quadrosrender_shot_sequenceO MP4
A narração ganha voz, é alinhada palavra por palavra, vira um plano com quadros exatos e é renderizada.

Dar voz à narração

Chame generate_speech com o roteiro da narração. Leia a URL do áudio na saída do job. 33 créditos com ElevenLabs v3.

Alinhar as palavras

Chame forced_alignment com o áudio e exatamente o mesmo roteiro como transcript. Leia output_data.alignment, uma lista de { word, start, end } em segundos. 33 créditos.

Resolver o briefing

Chame resolve_shot_sequence com o briefing, a URL do áudio e o alinhamento. A ferramenta responde na hora com o plan pronto para renderizar e eventuais warnings. Gratuito.

Renderizar

Chame render_shot_sequence com o plano. O job renderiza o MP4, que o cartão reproduz e a sua biblioteca guarda. 55 créditos, em qualquer tamanho de quadro.

Chame start_video_director primeiro: a ferramenta retorna o guia para escrever a narração como frases de deixa e montar um bom briefing.

Escrever um briefing

Um briefing tem uma narration, com seu script e suas cues, e scenes que contêm shots, que por sua vez contêm reveals. Uma deixa é uma frase do roteiro. Uma revelação posiciona um elemento quando uma deixa é dita.

{
  "fps": 30, "width": 1920, "height": 1080, "backgroundColor": "#0b0b0f",
  "narration": {
    "script": "Ship faster. Nodaro turns your idea into video.",
    "cues": [
      { "id": "c_ship", "text": "Ship faster" },
      { "id": "c_idea", "text": "your idea into video" }
    ]
  },
  "scenes": [
    {
      "id": "scene_hook",
      "shots": [{
        "id": "shot_1",
        "reveals": [
          {
            "id": "rv_title",
            "element": { "id": "t1", "type": "text", "text": "Ship faster", "fontFamily": "Inter", "fontSize": 120, "fontWeight": 900, "color": "#ffffff", "x": 200, "y": 450 },
            "revealAt": { "kind": "cue", "cueId": "c_ship", "edge": "start" },
            "enter": { "motion": "slide-up", "durationFrames": 12, "easing": "easeOut" }
          }
        ]
      }]
    }
  ]
}

Âncoras

ÂncoraQuando o elemento aparece
{ "kind": "cue", "cueId": "…", "edge": "start" }Quando a frase da deixa começa. Use "edge": "end" para quando ela termina e offsetMs para ajustar o momento.
{ "kind": "frame", "frame": 0 }Em um quadro fixo, para elementos sem narração, como um logo de abertura ou um encerramento

Para um elemento que precisa estar visível na miniatura, no quadro 0, use "enter": { "motion": "none", "durationFrames": 0 }.

Quanto tempo um elemento fica

Um elemento sai no fim do conteúdo da cena dele. Para controlar como ele sai, defina hold, os quadros em que ele permanece depois da entrada, e exit, um movimento após essa permanência.

Regras que mantêm o tempo exato

  • As deixas precisam corresponder exatamente ao roteiro, inclusive nos espaços. Escreva a forma falada: “twenty twenty-six”, e não “2026”; “five dollars”, e não “$5”.
  • As cenas não podem se sobrepor no tempo. Cada cena ocupa um trecho contínuo da narração. Quando as revelações de duas cenas se sobrepõem, resolve_shot_sequence retorna 422 scene_overlap.
  • As fontes vêm das famílias compatíveis, como Inter, Roboto, Montserrat, Poppins, Playfair Display, Bebas Neue, Anton, Caveat, Roboto Mono e Fira Code. Rubik, Heebo, Cairo e Tajawal cobrem hebraico e árabe.
  • Os movimentos de entrada são fade, scale-up, wipe-in, slide-up, slide-down, slide-left, slide-right e none.
  • Os movimentos de saída são fade, slide-up, slide-down, slide-left, slide-right e none.

Uma deixa que não é encontrada na transcrição passa a usar um tempo proporcional, e warnings informa isso.

Blueprints

Um blueprint é um trecho animado pronto que você posiciona com uma revelação blueprint e preenche com params. list_shot_shapes retorna o catálogo, e get_shot_shape retorna os parâmetros de um blueprint com um exemplo completo. Os blueprints não custam nada por si só; o preço da renderização cobre o vídeo inteiro.

IDFunçõesQuadros padrãoO que faz
comparison-splitvitrine de recurso180Dois painéis com rótulos entram deslizando por lados opostos e ficam parados com um divisor; selos opcionais surgem perto do fim.
constellation-hubgancho, prova social180Nós com rótulos saltam para formar um anel em volta de um centro, e depois a tomada termina no núcleo.
cta-morph-presschamada para ação150Um botão aparece no centro, e um cursor desacelera até ele e o pressiona.
cursor-ui-demovitrine de recurso, apresentação do produto210Um cursor conduz suas capturas de tela por cliques, enquanto a visualização acompanha cada alvo.
dataviz-countupponto de dor240Um número grande sobe em contagem até um valor, com um rótulo.
device-surface-showcaseapresentação do produto, vitrine de recurso240Uma maquete de dispositivo fica parada enquanto as telas dela alternam entre suas capturas de tela, com títulos sincronizados.
grid-card-assemblevitrine de recurso, benefício, prova social180Cartões de texto caem em cascata e formam uma grade.
kinetic-type-beatsgancho150De uma a quatro frases de efeito se alternam; a última surge com uma cor de destaque.
logo-assemble-lockupapresentação do produto, branding180As letras da palavra da marca se juntam em uma assinatura centralizada, com um slogan opcional.
overwhelm-surroundponto de dor210Cartões de ferramentas se juntam e etiquetas se espalham pela tela; depois, demandas se aproximam por todos os lados.
spatial-pan-stationsgancho, ponto de dor240Estações com rótulos em uma única tela grande, visitadas por panorâmicas suaves da câmera, com um destaque em cada parada.
ticker-takeovergancho, branding180Uma introdução digitada com uma palavra de destaque que se alterna, e depois o elemento principal entra com impacto.
titlecard-revealbenefício, prova social120Um título limpo, com subtítulo opcional, revelado com um único movimento discreto e mantido na tela.
typewriter-revealgancho, branding180O texto é digitado letra por letra com um cursor piscando; um rótulo secundário opcional surge suavemente de baixo.
waterfall-revealgancho, vitrine de recurso150As palavras de uma linha entram uma a uma, da esquerda para a direita; um rótulo secundário opcional surge suavemente de baixo.

As durações padrão estão em quadros a 30 fps. list_shot_shapes sempre retorna o catálogo atual.

Tokens de marca

Um briefing pode levar tokens de marca, com paleta, fontes e logo, para que todos os blueprints usem as suas cores e a sua tipografia. Em um briefing, os tokens precisam ser o objeto completo, não o ID de uma predefinição: copie os tokens de uma predefinição de list_brand_presets. Os campos são os mesmos da marca do Diretor de vídeo.

Perguntas frequentes

Última atualização

Nesta página