OpenMotion para vídeo: onde conectar a chave API? Geração de imagem e narração usam a interface compatível; a câmera precisa de conexão separada.

Nota do autor: seguindo o README, as notas de lançamento e a documentação do provedor, destrincho as cinco etapas de produção do OpenMotion, explico a quais delas uma única chave compatível com OpenAI consegue se conectar e mostro como gerar fora os planos que não encaixam para depois importá-los.

Quando você resolve fazer um vídeo seu com o OpenMotion e tem uma chave API na mão, a primeira reação de muita gente é colocá-la na conexão compatível com OpenAI em Model Settings e esperar que geração de imagens, narração, planos e trilha sonora funcionem de ponta a ponta. Só que, conforme a documentação do repositório, uma chave compatível, no OpenMotion, corresponde apenas a dois protocolos: geração de imagens e narração. A transcrição de legendas é uma terceira interface separada, e os planos de vídeo e a trilha sonora não ficam no slot compatível.

Este não é mais um texto sobre a popularidade de um repositório, e não vou usar o número de estrelas como conclusão; apenas comparo o README, as notas de lançamento da v0.1.1 e a documentação do provedor, verificando ponto por ponto onde a chave consegue se conectar. Todas as descrições de capacidade trazem a fonte — nenhuma delas vem de teste real.

O valor central: depois de ler este texto, você vai conseguir decidir sozinho quais etapas entregar à interface compatível, quais trocar de provedor e quais gerar primeiro fora e depois importar para o OpenMotion.

openmotion-api-key-image-narration-video-setup-pt-pt-image-0


Pontos principais sobre como conectar as chaves de API para fazer vídeos no OpenMotion

Vamos direto à conclusão em uma tabela. O “protocolo esperado” da tabela vem dos arquivos docs/provider-settings.md e compatible.md do repositório, e representa o que o lado do OpenMotion implementou — não significa que qualquer plataforma ofereça o endpoint correspondente.

Etapa de produção Protocolo esperado pelo OpenMotion A chave compatível pode conectar direto? Próximo passo quando não conecta
Geração de imagens POST base + /images/generations, lê b64_json ou url Sim, desde que a plataforma ofereça esse endpoint Escolha uma plataforma que tenha endpoint de geração de imagens
Narração POST base + /audio/speech, com input no corpo, obrigatoriamente com voice, retorna áudio binário O protocolo está implementado, mas a plataforma precisa realmente ter esse endpoint Troque para um fornecedor que tenha esse endpoint, ou importe seu próprio áudio gravado
Legendas POST base + /audio/transcriptions, precisa ter timestamps reais É outra interface, não é compartilhada com a narração Escreva à mão ou importe um arquivo de legendas no Studio
Tomadas Usa fal.ai, Atlas Cloud, WaveSpeedAI ou OpenDesign Cloud Não Gere o vídeo final externamente e importe
Trilha sonora/efeitos sonoros Igual às tomadas; o protocolo compatível não implementou música nem efeitos sonoros Não Troque de fornecedor, ou importe seu próprio áudio

A interface compatível do OpenMotion só reconhece geração de imagens e narração

O docs/provider-settings.md do repositório é bem direto: as conexões compatíveis com OpenAI executam /images/generations e o endpoint binário /audio/speech; para voz, é obrigatório enviar voice. A Anthropic e o Google Gemini aqui só fazem configuração de catálogo; não existe um adaptador de mídia genérico. Portanto, mesmo que você insira uma chave do Claude ou do Gemini, isso não faz surgir capacidade de geração de imagens ou narração do nada. Já vídeo e música ficam explicitamente por conta de fal.ai, Atlas Cloud, WaveSpeedAI ou OpenDesign Cloud.

O compatible.md também define os limites do adaptador compatível. A geração de imagens faz apenas texto para imagem: não faz upload nem edição de imagens, e também não faz vídeo assíncrono. A narração retorna áudio binário, mas os protocolos de música e efeitos sonoros não foram implementados. O docs/model-gateway.md (com atualização indicada em 2026-11-15) acrescenta uma observação: as conexões compatíveis genéricas implementam o protocolo padrão de voz, o que não significa que tenham uma interface portável para música ou efeitos sonoros. Em outras palavras, a “compatibilidade” vai só até a voz.

Não confunda as três listas de modelos no README do OpenMotion

O README traz três listas em locais diferentes, com propósitos distintos; elas não podem ser juntadas em uma única “tabela de modelos suportados pelo OpenMotion”.

  • Exemplos do início: dá exemplos de geração de imagens, adição de planos, trilha sonora e narração com GPT Image 2.6, Seedance 2.5, Suno e Eleven v4, só para mostrar como é o fluxo de trabalho.
  • Seção do catálogo da fal.ai: depois de conectar a fal.ai em Model Settings e atualizar o catálogo, você encontra GPT Image 2.6, Nano Banana 2.1, FLUX.3, Seedance 2.5, Kling 4.0, Wan 3.0 e Eleven v4. Esse é o catálogo via fal.ai.
  • Tabela de capacidades: em imagem: Codex Image, Nano Banana 2 via Atlas Cloud e FLUX Schnell via fal.ai; em vídeo: Seedance 2.0 via Atlas Cloud e Wan 2.2 via fal.ai; em música: Suno v4 via Atlas Cloud; em voz: Kokoro via fal.ai.

Estas três listas respondem a três perguntas diferentes: “como é o fluxo de trabalho”, “o que existe no catálogo de um fornecedor” e “quais integrações a documentação lista”. Ver Seedance 2.5 no início não significa que a sua chave compatível consiga gerar planos com Seedance diretamente no OpenMotion.

openmotion-api-key-image-narration-video-setup-pt-pt-image-1


Início rápido com OpenMotion para criar vídeos: conectando as chaves etapa por etapa

A seguir, vamos percorrer o processo na ordem de produção do vídeo. Em cada etapa, primeiro explicamos o que o OpenMotion espera, e depois se a chave que você tem em mãos consegue atender.

Primeiro passo: preparar o ambiente local do OpenMotion

Os requisitos listados na seção de instalação do README são os seguintes; recomenda-se confirmar que o ambiente está completo antes de conectar as chaves:

  1. Node.js 26.11.1: a versão indicada no README.
  2. A instalação a partir do código-fonte é o método padrão: o aplicativo publicado no npm é opcional; o próprio README lembra que published versions can lag (as versões publicadas podem ficar defasadas), e recursos novos podem demorar a chegar.
  3. Chrome ou Chromium, além do FFmpeg: a pré-visualização local e a exportação dependem deles.
  4. Docker Compose (opcional): as notas de lançamento da v0.1.1 dizem que dá para abrir o Studio localmente a partir do código-fonte usando Docker Compose.

O README também deixa claro que o software em si não cobra assinatura, nem taxa de renderização por uso; cada fornecedor cobra conforme a sua própria conta. Além disso, também é possível não chamar nenhuma interface de geração e importar diretamente suas próprias cenas, imagens e áudios — algo que será usado repetidamente nas etapas que não conseguirem se conectar mais adiante.

Passo 2: configurar uma conexão compatível no slot de geração de imagens do OpenMotion

A geração de imagens é a parte mais estável quando se usa chaves compatíveis. Usando a APIYI como exemplo, ela é uma plataforma de agregação de modelos compatível com OpenAI: uma única chave permite chamar vários modelos populares, e seu endpoint de geração de imagens /v1/images/generations corresponde exatamente ao caminho exigido pelo adaptador de geração de imagens do OpenMotion. Em Model Settings, o preenchimento fica mais ou menos assim:

Campo O que preencher Descrição
Tipo de conexão Compatível com OpenAI Apenas este tipo usa /images/generations
Base URL https://api.apiyi.com/v1 O adaptador acrescenta /images/generations ao final
API Key Token criado no console da plataforma Atenção: o grupo do token deve incluir o grupo do modelo selecionado
Modelo de imagem gpt-image-2.6-all, gpt-image-2.6-flare ou gpt-image-2.6-sunburst Corresponde ao GPT Image 2.6 dos exemplos do README
Formato de retorno b64_json ou url O adaptador consegue ler os dois

Depois de preencher, gere primeiro um frame estático para confirmar que o fluxo está funcionando. Vale notar que o adaptador de geração de imagens compatível do OpenMotion não faz upload para edição de imagens; a operação de “alterar uma imagem existente” não funciona nesse fluxo. Você só pode gerar novamente ou importar uma imagem já editada externamente.

🚀 Início rápido: para a parte de geração de imagens, recomendamos primeiro gerar uma imagem com sucesso no APIYI (apiyi.com) usando a cota gratuita de teste para novos usuários, confirmar se Base URL, grupo do token e ID do modelo estão corretos, e só depois gerar os frames estáticos do storyboard em lote.

Passo 3: confirmar primeiro os endpoints da narração e das legendas do OpenMotion

O slot de narração precisa de /v1/audio/speech, e o slot de legendas precisa de /v1/audio/transcriptions: são duas interfaces diferentes. De acordo com a interface de preços do APIYI lida em 2026-11-20, os endpoints públicos são apenas /v1/messages, /v1/embeddings, generateContent do Gemini, /v1/images/generations, /v1/chat/completions e /v1/responses; não existe /v1/audio/speech nem /v1/audio/transcriptions.

Na tabela geral, os endpoints de tts-1 e tts-1-hd só têm chat listado, enquanto o adaptador de narração do OpenMotion envia requisições para /audio/speech. Portanto, não adianta preencher esses dois IDs de modelo no slot de narração e esperar que saia áudio. Para a narração, existem dois caminhos: trocar para um fornecedor que realmente ofereça /audio/speech e aceite o parâmetro voice, ou gravar o áudio você mesmo e importá-lo diretamente.

Já as legendas são mais simples na v0.1.1. As notas de lançamento dizem que no Studio é possível gerar, importar ou escrever legendas à mão e depois exportar em SRT ou VTT. A seção de legendas do compatible.md (verificada em 2026-11-17) lembra que só dá para exportar SRT ou VTT quando se tem timestamps reais; com apenas o texto, é impossível montar uma linha do tempo. Sem um endpoint de transcrição, escrever à mão ou importar um arquivo de legendas com linha do tempo é o caminho mais direto.

Etapa 4: clipes do OpenMotion — gerar externamente e importar depois

O segmento de clipe não pode ser inserido no slot de compatibilidade. Para gerar clipes diretamente no OpenMotion, ainda é preciso passar por fal.ai, Atlas Cloud ou WaveSpeedAI; se seus créditos de vídeo estiverem em outra plataforma, gere o vídeo final por lá e importe o arquivo para o Studio. A exportação de MP4 de segmento único adicionada na v0.1.1 também facilita inspecionar separadamente os trechos com clipes substituídos. A próxima seção explica em detalhes como gerar externamente com o Seedance 2.5.

openmotion-api-key-image-narration-video-setup-pt-pt-image-2


Como conciliar modelos e preços de geração de imagens do OpenMotion

O erro mais comum ao consultar modelos e preços é misturar os números de páginas diferentes em um único preço. A seguir, listo as três fontes da APIYI separadamente; as datas de leitura estão no cabeçalho da tabela e, quando há divergência entre duas fontes, mantenho as duas.

ID do modelo Tabela geral (dados de 2026-11-19 10:59) API de preços (leitura em 2026-11-20) Página de descrição
gpt-image-2.6-all Por chamada, 0.025 dólares/chamada; endpoints chat, images; grupos Default, image2_OSS, SVIP model_price 0.025; endpoints image-generation, openai A página de descrição informa gpt-image-2-all a 0.025 dólares/imagem, e não 2.6
gpt-image-2.6-flare Por chamada, 0.2 dólares/chamada; o endpoint lista apenas images; grupos Default, image2Enterprise, image2_OSS, SVIP model_price 0.2, e também traz billing_expr (p * 5 + cr * 1.25 + img * 8 + img_cr * 2 + c * 30); endpoints image-generation, openai No canal oficial, a cobrança é por token: entrada de texto 5, entrada de imagem 8, saída de imagem 30 dólares por milhão de tokens; leitura de cache de texto 1.25, de imagem 2 dólares
gpt-image-2.6-sunburst O mesmo que flare: 0.2 dólares por chamada; o endpoint lista apenas images O mesmo que flare Igual ao acima, por token

Dá para ver que a tabela geral descreve flare e sunburst como cobrança por chamada de 0.2 dólares, com apenas images nos endpoints, enquanto a API de preços, além do 0.2, também inclui uma fórmula de cobrança por token e acrescenta openai aos endpoints. Já a página de descrição lista o preço do canal oficial por token e informa que o texto para imagem pelo canal oficial usa /v1/images/generations e retorna b64_json. Essas fontes não dizem exatamente a mesma coisa; este artigo não combina os valores em um preço único. Para a cobrança real, vale a lista de modelos do console do apiyi.com no momento do pedido.

Para o slot de geração de imagens do OpenMotion, a informação decisiva é, na verdade, o endpoint: os endpoints de imagem dos três modelos correspondem a /images/generations, e o formato de retorno também é b64_json, que o adaptador consegue ler.

Quanto a trilha sonora e narração, o Suno e o Eleven v4 citados como exemplo no README não aparecem na tabela geral de 2026-11-19 nem na API de preços de 2026-11-20; a tabela geral também não traz whisper. Suno e Eleven v4 ainda não estão disponíveis; vamos disponibilizar esses modelos o quanto antes. Modelos e preços devem ser consultados na lista de modelos da plataforma.

openmotion-api-key-image-narration-video-setup-pt-pt-image-3


Seção de tomadas do OpenMotion: por que o Seedance 2.5 não entra no slot de compatibilidade

O ID de modelo do Seedance 2.5 na APIYI é doubao-seedance-2-5-260628. Ele não entra no slot de compatibilidade do OpenMotion por dois motivos: o adaptador de compatibilidade do OpenMotion simplesmente não lida com vídeo assíncrono, e o doubao-seedance-2-5-260628 na APIYI também usa a própria interface de tarefas, não a interface de vídeo compatível.

Item Tabela geral (2026-11-19) Endpoint de precificação (2026-11-20) Página explicativa do Seedance2
Endpoint Apenas chat Somente openai (ou seja, chat) POST /seedance/api/v3/contents/generations/tasks
Grupo SeeDance2 Apenas SeeDance2; os multiplicadores dos grupos SeeDance2, SD2Fast e SD2Mini são todos 0.18 No token, é preciso marcar SeeDance2; multiplicador 0.18x
Formato do preço Por uso, entrada 70 e saída 70 dólares por milhão de tokens; leitura de cache sem dados Mesmo modelo, convertido pelo multiplicador do grupo Exemplo com 720p, 5 segundos e sem vídeo de entrada: US$ 1.3721
Modelo de cobrança Por uso Por uso Por uso (preferencial) ou por uso

Há dois números aqui que não devem ser confundidos. Os 70 dólares por milhão de tokens na tabela geral são o preço de tabela; os 1.3721 dólares da página explicativa são um exemplo concreto, que já aplica o multiplicador 0.18 do grupo SeeDance2. Multiplicar o preço de tabela da tabela geral por 0.18 dá 12.60 dólares por milhão de tokens; depois, multiplicando pelos 108900 tokens usados no exemplo da página explicativa, chega-se a aproximadamente 1.37 dólares, o que corresponde exatamente àquele exemplo. Portanto, eles descrevem dois níveis da mesma estrutura de cobrança, e não dois preços entre os quais se possa escolher.

Os nomes dos grupos também divergem: a tabela geral escreve fast e mini como SD2-Fast-Cheap e SD2-Mini-Cheap, enquanto o endpoint de precificação os chama de SD2Fast e SD2Mini. Ao criar o token, use como referência o nome do grupo que aparece de fato no console; não preencha à força seguindo o nome de uma página específica.

Na prática, no fluxo de produção: primeiro envie a tarefa de tomada no endpoint de tarefas do Seedance da APIYI; quando a tarefa terminar, baixe o vídeo final; depois importe o arquivo de vídeo para a linha do tempo do OpenMotion e faça a edição junto com os frames estáticos gerados pela interface compatível e a narração gravada externamente.

💡 Sugestão de escolha: se você quer gerenciar a cota de tomadas e a cota de geração de imagens sob a mesma chave, pode, na APIYI (apiyi.com), marcar no token tanto o grupo de geração de imagens quanto o grupo SeeDance2; as imagens entram no OpenMotion, e as tomadas são geradas pelo endpoint de tarefas e depois importadas. Assim, a cobrança fica fácil de conferir em um único painel.


Perguntas frequentes (FAQ)

P1: O que é o OpenMotion?

O OpenMotion é um Studio de produção de vídeo open source publicado pela nexu-io, com licença Apache-2.0 e repositório criado em 2026-05-11. A descrição do repositório diz que ele suporta 22 agentes, citando nominalmente Claude Code, Codex, DSH e WorkBuddy. Segundo o README, o software em si não cobra assinatura nem taxa de renderização; as interfaces de geração são cobradas na conta do seu próprio fornecedor.

P2: Qual é a diferença entre a interface compatível do OpenMotion e o fal.ai e o Atlas Cloud?

A interface compatível no OpenMotion executa apenas dois protocolos: `/images/generations` e `/audio/speech`. As legendas seguem outro caminho, `/audio/transcriptions`. Já fal.ai, Atlas Cloud, WaveSpeedAI e OpenDesign Cloud é que são os canais de vídeo e música indicados na documentação. Se você quer gerar cenas direto dentro do Studio, só dá para usar essas últimas.

P3: Quando o OpenMotion v0.1.1 foi lançado e o que mudou?

O v0.1.1 foi lançado em 2026-11-18 às 19:32 (horário de Pequim). De acordo com as notas de lançamento: as legendas podem ser geradas, importadas ou escritas à mão, e exportadas em SRT ou VTT; é possível exportar um trecho específico em MP4 separadamente; foram adicionadas 96 Skills; dá para abrir o Studio localmente a partir do código-fonte usando Docker Compose; e um plugin opcional DeepSeek Harness coloca o Studio ao lado da conversa. Tudo isso vem das notas de lançamento, não de conclusões de testes práticos.

P4: Dá para colocar o tts-1 no slot de narração do OpenMotion?

Não dá para fazer isso diretamente. O slot de narração envia requisições para `/v1/audio/speech`, que precisam incluir `voice` e retornam áudio binário; já na tabela geral da APIYI, o endpoint de `tts-1` e `tts-1-hd` mostra só chat, e os endpoints públicos da interface de preços também não têm `/v1/audio/speech`. Para a narração, a sugestão é usar outro fornecedor que ofereça esse endpoint, ou gravar o áudio e importar.

P5: Como conectar rapidamente a geração de imagens ao OpenMotion via API?

São poucos passos:

1. Cadastre-se em APIYI apiyi.com e receba a cota gratuita de teste.
2. Crie um token cujo grupo inclua o grupo do modelo de imagem que você vai usar, por exemplo Default.
3. No OpenMotion Model Settings, crie uma nova conexão compatível com OpenAI, preencha o Base URL com `https://api.apiyi.com/v1` e coloque no modelo um ID disponível como `gpt-image-2.6-all`.
4. Gere uma imagem estática para validar; o adaptador vai ler o `b64_json` ou a `url` retornada.

P6: Como colocar no OpenMotion as cenas geradas pelo Seedance 2.5?

Use `doubao-seedance-2-5-260628` para enviar a tarefa na interface de tarefas `POST /seedance/api/v3/contents/generations/tasks`, marcando o token no grupo SeeDance2. Quando a tarefa terminar, baixe o arquivo de vídeo e coloque na linha do tempo do OpenMotion importando como material. Quanto ao preço, veja os dois lugares separadamente: na tabela geral o valor é 70 dólares por milhão de tokens tanto na entrada quanto na saída; já o exemplo de 720p e 5 segundos na página de descrição equivale a 1,3721 dólar depois da conversão.

P7: Quais são as limitações conhecidas dessa integração?

– **Geração de imagens**: o adaptador de compatibilidade não faz upload para edição de imagem, apenas texto para imagem.
– **Narração e legendas**: o protocolo OpenMotion já está implementado, mas é preciso que a plataforma realmente ofereça `/audio/speech` e `/audio/transcriptions`; sem timestamps reais, não dá para exportar as legendas em SRT ou VTT.
– **Trilha sonora e efeitos sonoros**: não implementados no protocolo de compatibilidade, só dá para usar fal.ai, Atlas Cloud, WaveSpeedAI, OpenDesign Cloud, ou importar seu próprio áudio.
– **Critério de preço**: a tabela geral, a interface de preços e a página de descrição não usam exatamente a mesma nomenclatura para o mesmo modelo; antes de comprar, considere a lista de modelos da plataforma como referência.


Principais pontos: OpenMotion para vídeo com chave API

  • O slot de compatibilidade só reconhece dois protocolos: geração de imagens em /images/generations e narração em /audio/speech; a legenda é a terceira interface.
  • Cenas e trilha sonora não entram no slot de compatibilidade: para gerar dentro do Studio, é preciso usar fal.ai, Atlas Cloud, WaveSpeedAI ou OpenDesign Cloud.
  • Não junte as três listas do README: os exemplos do início, o catálogo fal.ai e a tabela de capacidades servem a propósitos diferentes.
  • Há modelos de geração de imagens já disponíveis: gpt-image-2.6-all, gpt-image-2.6-flare e gpt-image-2.6-sunburst todos correspondem ao endpoint de imagem.
  • Veja o preço separado por fonte: a tabela geral cobra por chamada, a interface de preços traz fórmula, a página de descrição cobra por token — não dá para fundir tudo em um preço só.
  • Se não conectar, gere fora e importe: o Seedance 2.5 produz o vídeo pelo endpoint de tarefas; baixe e importe na linha do tempo.
  • Para começar, rode uma imagem primeiro: use a cota gratuita da APIYI para validar a Base URL e o grupo do token, e depois expanda para as outras etapas.

Resumo

Para fazer seu próprio filme com o OpenMotion, a configuração da chave se resume a três pontos:

  1. Geração de imagens via interface compatível: aponte a Base URL para a plataforma que oferece /images/generations e preencha com o ID do modelo GPT Image 2.6 hospedado.
  2. Verifique os endpoints de narração e legendas primeiro: o protocolo do OpenMotion é compatível, mas se a plataforma não tiver /audio/speech nem /audio/transcriptions, troque de provedor ou escreva/importe manualmente.
  3. Cenas e trilha sonora são à parte: gere o material final externamente e importe, ou conecte fal.ai, Atlas Cloud e WaveSpeedAI dentro do Studio.

Antes de começar, liste as interfaces correspondentes a cada etapa conforme a tabela de seções deste artigo — isso economiza muito mais tempo do que preencher todas as chaves de uma vez e depois ficar caçando erros. As duas etapas de geração de imagens e cenas Seedance podem ser gerenciadas com um único token no APIYI apiyi.com; valide o fluxo com a cota gratuita primeiro e depois decida a divisão de trabalho do filme final.


📚 Referências

  1. Repositório e README do OpenMotion: requisitos de instalação, três listas de modelos, detalhes de cobrança

    • Link: github.com/nexu-io/openmotion
    • Descrição: leitura do branch main em 20/11/2026, incluindo versão do Node.js, dependências do Chrome e FFmpeg
  2. Notas de lançamento do OpenMotion v0.1.1: legendas, exportação de segmento único, Docker Compose e outras atualizações

    • Link: github.com/nexu-io/openmotion/releases/tag/v0.1.1
    • Descrição: publicado em 18/11/2026; as descrições de recursos de versão neste artigo vêm desta página
  3. Documentação de provedores do OpenMotion: limites de protocolo executáveis por interfaces compatíveis

    • Link: github.com/nexu-io/openmotion/blob/main/docs/provider-settings.md
    • Descrição: docs/model-gateway.md e skills/openmotion-media/references/providers/compatible.md no mesmo diretório complementam detalhes das três interfaces: geração de imagens, voz e legendas
  4. Tabela geral de modelos, página de capacidades e endpoint de preços da APIYI: IDs de modelo, endpoints, grupos e preços

    • Link: docs.apiyi.com/models.md
    • Descrição: as páginas /api-capabilities/gpt-image-2/overview.md e /api-capabilities/seedance2/overview.md no mesmo site são páginas explicativas; o caminho do endpoint de preços é /api/pricing no subdomínio api, com pricing_version shell-api-modelmak-v1

Autor: Equipe técnica da APIYI
Contato técnico: se durante a integração surgirem problemas de incompatibilidade entre modelos, grupos ou endpoints, fale conosco pela página inicial do site oficial da APIYI

Deixe um comentário