Como usar a API do Seedance 2.5 via Ofox?

Crie uma tarefa de geração via POST https://api.ofox.ai/v1/videos com sua Ofox API key, depois consulte o status da tarefa até que ela seja concluída e baixe o vídeo em mirror_urls (ou unsigned_urls).

O que fazer se a geração falhar?

Guarde o ID da tarefa, consulte primeiro o status e a mensagem de erro e então decida se ajusta os parâmetros ou cria uma nova tarefa. Não reenvie seguidamente enquanto o resultado não estiver claro; se falhas são cobradas depende das regras do serviço e da sua fatura.

Primeiro/último quadro e imagens de referência são a mesma coisa?

Não. Primeiro e último quadro definem a imagem de início ou de fim do vídeo e usam frame_images; materiais de referência comuns orientam sujeito, estilo etc. e usam input_references. Os dois não podem aparecer na mesma requisição.

Por que a amostra não muda quando edito o prompt?

As amostras da área de trabalho são resultados antigos dos prompts originais e servem para você avaliar o resultado. Suas edições vão para a requisição da API; ao clicar em “Gerar vídeo”, a nova tarefa é gerada no OfoxAI Studio.

O Seedance 2.5 é bom para vídeos com som?

O Seedance 2.5 tem suporte a áudio sincronizado, e várias amostras desta página trazem áudio nativo que você pode ouvir. Mas sincronia labial, pronúncia, som ambiente e continuidade dos personagens ainda precisam ser verificados item por item com o seu material; teste primeiro com vídeos curtos e depois aumente a duração.

Como comparar o Seedance 2.5 com outros modelos de vídeo?

Use a mesma entrada, duração, resolução e critérios de aprovação, e registre resultados, custo e número de falhas. As amostras desta página mostram apenas o Seedance 2.5 e não servem para montar um ranking entre modelos.

Dá para editar ou estender um vídeo existente diretamente?

“Referência de vídeo” não é o mesmo que editar ou estender. As instruções e os endpoints de edição ou extensão precisam ser verificados à parte; a área de trabalho não oferece opções de edição ou extensão não verificadas.

Por que o número de referências divulgado pode ser diferente do limite da API?

O limite de capacidade do modelo não é o que todo provedor, endpoint de gateway e formulário web suportam. Vale o limite do endpoint que você está chamando; com muitos materiais misturados, valide primeiro com uma amostra mínima e aumente aos poucos.

O orçamento de teste inclui créditos gratuitos?

Não. O cálculo é o custo de uso estimado para a configuração escolhida, sem presumir créditos gratuitos, e não representa uma recarga mínima. Para os benefícios da sua conta, consulte as informações reais da conta.

Seedance 2.5

Video Generation

bytedance/seedance-2.5

Comece com um plano, e coloque a ideia em movimento.

Crie vídeos curtos a partir de texto, imagens ou referências de vídeo. Veja amostras reais primeiro, escolha parâmetros e orçamento, e depois leve a mesma tarefa para o seu produto.

4–30 spor vídeo
480p–1080presolução
Áudio sincronizadoopcional

Testar um vídeo Ver requisição da API

Cobrado por segundo gerado · veja o orçamento desta geração ao lado dos parâmetros

O Seedance 2.5 é o modelo multimodal de criação de vídeo de próxima geração da linha Doubao da ByteDance, lançado em 2026-08-07. Aceita entrada mista de texto, imagens, vídeos e áudio — até 30 imagens, 10 vídeos e 10 clipes de áudio, totalizando 50 materiais de referência — e cobre a geração de vídeo a partir de texto, de imagem e de vídeo. Cada clipe pode ter qualquer duração inteira em segundos entre 4 e 30, com resolução de 480p, 720p ou 1080p (720p por padrão), seis proporções de tela e uma opção adaptativa. A saída inclui áudio sincronizado por padrão e os prompts podem ser escritos em vários idiomas. Esta geração aprimora o seguimento de instruções, a narrativa com múltiplos planos e a consistência temporal em sequências longas. Acessível via protocolo OpenAI-compatible.

Prompt

867 / 4000

15 s × $0.24/s · Gera no OfoxAI Studio (requer login) · Base de preço e orçamento para várias rodadas ↓

Um plano-sequência por um navio de cruzeiro inteiro

Do tobogã do deque direto para a piscina, passando pelo restaurante, a cozinha e a casa de máquinas, até sair voando pela popa — veja se um plano longo sem cortes se mantém coerente do início ao fim.

Seedance 2.5720p · 15 s · 16:9 · sem áudioAmostra real

# 1. Create the generation task — keep the returned idcurl https://api.ofox.ai/v1/videos \  -H "Authorization: Bearer $OFOX_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "model": "bytedance/seedance-2.5",  "prompt": "Continuous single take, camera tilting, rolling, spinning, flying through a colossal luxury cruise ship. Starts flying over the sunny upper deck dodging beach balls and sunbathers, camera dives straight down a twisting, translucent water slide, gliding past screaming children before splashing into the main pool. Sweeps underwater, effortlessly passing through a glass floor directly into the elegant grand dining room below, weaving through crystal chandeliers, clinking champagne glasses, and waiters balancing silver trays. Camera dives past the spinning kitchen doors into the humming, immaculate engine control room, transitions out the stern exhaust vent, gliding over the churning, foamy white wake as the sun sets over the ocean. No cuts, impossible camera moves, seamless transitions, energetic, dynamic, cinematic. 8K high definition, high quality footage.",  "duration": 15,  "resolution": "720p",  "aspect_ratio": "16:9",  "generate_audio": false,  "provider": {    "type": "byteplus"  }}' # Or: "provider": { "type": "volcengine" } # 2. Poll with that id until status is completed / failed / cancelled / expiredcurl https://api.ofox.ai/v1/videos/$TASK_ID \  -H "Authorization: Bearer $OFOX_API_KEY" # 3. Read mirror_urls[0] (persistent), or unsigned_urls[0] (expires in ~24h)

Próximo passoGET /v1/videos/{id} → mirror_urls[0]Fluxo completo de integração ↓

Trocar amostraClique em uma amostra para carregar o prompt e os parâmetros originais · Origem das amostras ↗

Entenda o modelo antes de escolher por onde começar

O que o Seedance 2.5 consegue fazer?

O Seedance 2.5 é o modelo de geração de vídeo da ByteDance. Ele transforma descrições de cena e materiais de referência em planos com movimento, com suporte a áudio sincronizado; na Ofox, o acesso é feito pela API unificada de tarefas de vídeo.

Ver fonte das especificações do modelo

Primeiro, decida o que você quer controlar

Sem materiais, descreva a ação e o movimento de câmera em texto. Com uma imagem do sujeito, decida primeiro se você quer fixar a cena de abertura ou só aproveitar o sujeito e o estilo. Com um vídeo, explique claramente o movimento que deve servir de referência.

Texto → vídeo
Ideal para validar primeiro uma direção visual. Descreva sujeito, ação, cena e câmera — sem precisar preparar materiais de referência.
Verifique primeiro:O sujeito está claro e a ação, completa?
Imagem → vídeo
O primeiro quadro define o ponto de partida do plano; o último quadro restringe a cena final. Já imagens de referência comuns orientam sujeito e estilo — um papel diferente.
Verifique primeiro:Cenas de início e fim, detalhes do sujeito e a transição.
Vídeo → geração por referência
Ideal para transmitir a intenção de movimento, enquadramento ou ritmo. Diga o que usar como referência e o que mudar — não escreva só “faça igual”.
Verifique primeiro:O movimento está adequado? A referência foi mal aproveitada?

Duração: 4–30s
Qualquer número inteiro de segundos, até 30 s por vídeo
Resolução de saída: 1080p
Até 1080p, 720p por padrão
Proporção: 7proporções
21:916:94:31:13:49:16Adaptável
Áudio: Áudio sincronizado
Imagem e som gerados de uma vez, com opção de ativar ou desativar
Entrada: 3tipos de entrada
TextoImagens de primeiro e último quadroVídeo de referência

Mais material de referência não significa resultado mais controlável. Diga para que serve cada material: quem é o sujeito, onde fica a cena, que movimento precisa ser mantido. Não deixe várias descrições conflitantes disputarem o mesmo plano.

Lançado em 2026-08-07bytedance/seedance-2.5

Capacidade do modelo, suporte do provedor e restrições da API são três camadas distintas. Quantidade de referências, tamanho dos materiais e combinações disponíveis dependem do endpoint escolhido; a área de trabalho demonstra apenas uma única referência de vídeo ou primeiro e último quadro, e não trata os limites divulgados do modelo como recursos do formulário.

Resultados que você pode ver

Não só o vídeo pronto — também como ele foi filmado

6 tarefas diferentes, 6 prompts originais. Observe movimento, materiais e pessoas, e então avalie se serve para o seu projeto.

Explorar mais exemplos de prompts

Câmera · plano-sequência

Cinco ambientes, sem cortes

Deque, tobogã, piscina, restaurante e casa de máquinas, tudo de uma vez. Observe se as transições fluem e se a lógica espacial se mantém.

Produto · anúncio vertical

Um anúncio de sobremesa em dois parágrafos

O prompt tem só dois parágrafos. Avalie a iluminação, as camadas dos ingredientes e o acabamento em fundo branco para ver se serve direto para e-commerce.

Personagem · áudio nativo

Planos escritos numa linha do tempo, com som incluído

Cada um dos três planos descreve imagem e áudio. Verifique a consistência da personagem e se a música acompanha os dedos.

Animação · atuação emocional

Faça dois personagens interagirem

Virar a cabeça, encostar o focinho, abraçar, com a câmera avançando do plano médio ao close. Veja se a continuidade das ações e as mudanças de expressão convencem.

Timelapse · transformação contínua

Em câmera lenta, a transformação precisa ser estável

As pétalas se abrem uma a uma sobre um degradê limpo. Reduza a velocidade e procure quadros pulados ou cintilação.

Vários planos · cortes no ritmo

Dez planos, uma festa, quinze segundos

Enquadramento e movimento de câmera definidos segundo a segundo, com áudio nativo. Veja se ritmo, estilo visual e transições são coerentes.

Origem das amostras e condições de teste ›

As amostras foram geradas de fato pela OfoxAI com o bytedance/seedance-2.5, e os prompts são o texto exato usado na geração. Cada vídeo indica resolução, duração, proporção e se tem áudio; “Reutilizar este plano” carrega esses mesmos parâmetros. As amostras servem só para avaliar o resultado: não indicam taxa de sucesso nem sustentam comparações com outros modelos.

O prompt precisa dirigir a filmagem

Não escreva só “cinematográfico” — diga o que acontece no plano

Expresse sujeito, ação, câmera e restrições separadamente. Os modelos originais abaixo são ferramentas de rascunho; o resultado real precisa ser validado gerando.

01
Sujeito e cena
Quem, onde e quais detalhes reconhecíveis precisam ser mantidos.
02
Ação principal
Como a ação começa, como muda e onde termina.
03
Câmera e enquadramento
Tamanho do plano, direção do movimento, formato horizontal ou vertical e se cortes são permitidos.
04
Som e restrições
Som ambiente ou sem áudio; textos, logotipos ou ações que não podem aparecer.

Escolha um ponto de partida

Mostre com clareza um detalhe do produto

Um plano destaca um único diferencial: acabamento da superfície, estrutura ou um gesto de uso. Acerte o sujeito primeiro, depois pense em movimentos de câmera mais complexos.

Rascunho de promptProduto still · 5 s horizontal

Uma caneca de cerâmica sem marca sobre uma mesa de madeira limpa. A câmera avança devagar de um plano médio em direção à borda, enquanto uma luz lateral suave desliza pelo esmalte. A caneca fica parada, o fundo é simples e todo o vídeo é um único avanço contínuo. 5 segundos, 16:9, sem legendas, sem texto extra, sem áudio.

Prepare:: Uma descrição precisa do produto; se já tiver uma foto dele, use-a como primeiro quadro.
Aprove se:: Contorno, marcações e estrutura não se deformam.

Prenda a atenção com uma única ação

Monte a abertura e o fechamento em torno de uma ação clara. Deixe espaço para legendas na pós-produção — não peça ao modelo para gerar textos complexos na imagem.

Rascunho de promptAção do sujeito · 5 s vertical

Um adulto com roupa esportiva lisa em um estúdio bem iluminado dá uma volta completa e termina parado, de frente para a câmera. A câmera mantém um enquadramento fixo de corpo inteiro, com o sujeito sempre no centro; a roupa e os membros se movem com naturalidade. 5 segundos, 9:16 vertical, plano único, sem legendas, textos ou logotipos, sem áudio.

Prepare:: Sujeito, ação e composição vertical.
Aprove se:: A ação é fácil de entender e o sujeito não sai do quadro.

Avance a história com a reação de um personagem

Escreva primeiro a situação, a ação e a virada emocional do personagem. Não esconda relações confusas atrás de muitos cortes.

Rascunho de promptMudança emocional · 10 s horizontal

Um adulto está sentado junto a uma janela silenciosa, de início olhando para um envelope sobre a mesa; depois ergue a cabeça devagar e olha para fora, com a expressão passando da hesitação à calma. A câmera avança devagar de um plano médio e para em um close do rosto; figurino e ambiente permanecem iguais. 10 segundos, 16:9, plano único, sem legendas, sem texto extra, sem áudio.

Prepare:: Relações entre personagens, figurino e ordem dos planos.
Aprove se:: Expressões, figurino, primeiro plano e fundo mantêm a continuidade.

Deixe um processo fácil de entender

Divida o processo em ações observáveis; não faça mãos, ferramentas e objetos fazerem coisas demais ao mesmo tempo. Deixe as anotações necessárias para a pós-produção.

Rascunho de promptDemonstração de processo · 8 s horizontal

Vista de cima de uma bancada de madeira limpa. Um par de mãos dobra uma folha quadrada de papel ao meio, depois ao meio de novo, e termina um barquinho de papel simples, colocando-o no centro da mesa. A câmera fica totalmente parada; os movimentos das mãos são claros e em ritmo constante, e os vincos e a deformação do papel parecem reais. 8 segundos, 16:9, plano único, sem legendas, sem texto extra, sem áudio.

Prepare:: Ordem das ações, pontos de contato e estado final.
Aprove se:: O processo é contínuo e o contato e a deformação são convincentes.

Substitui o prompt, o modo e as configurações no Playground. Nada é gerado automaticamente.

Mude uma variável por vez

Na primeira rodada, avalie a composição; na segunda, ajuste a ação; na terceira, corrija a iluminação ou o ritmo. Guardar o prompt e o resultado de cada rodada facilita muito encontrar problemas, bem mais do que reescrever tudo de uma vez.

Custo claro desde o início

Quanto custa um vídeo — e três tentativas?

O orçamento acompanha a configuração atual. Valide a direção primeiro com vídeos curtos e só depois decida se aumenta a duração ou a resolução.

Orçamento de teste da configuração atual

Texto para vídeo · 720p · 15 s

Um vídeo

$3.60

Total de 3 rodadas

$10.80

Planejar 3 rodadas

Custo de uso estimado$10.80

Não é uma recarga mínima. Número de testes não é número de vídeos aproveitáveis; a cobrança real segue a sua fatura em tempo real.

Cobrado por segundo gerado
Resolução	Texto para vídeo / s	Vídeo para vídeo / s
480p	$0.11/s	$0.14/s
720p	$0.24/s	$0.3/s
1080p	$0.6/s	$0.71/s

Preços da Ofox em tempo real — os mesmos usados no orçamento à esquerda. Esta tabela não lista imagem para vídeo separadamente, então nenhum preço é presumido. As faixas listadas valem para qualquer configuração de áudio. Este modelo é servido por várias plataformas; use provider.type na requisição para escolher uma.

Ver fonte dos preços em tempo real

Divida a primeira validação em três etapas

Abaixo, sugestões de configuração de teste para texto para vídeo; os custos são calculados em tempo real com os preços atuais.

01 / Direção4 s · 480p$0.44/ rodada
Confirme pelo menor custo que o sujeito e a ação foram entendidos; se não, ajuste o prompt e tente de novo antes de subir a configuração.
02 / Detalhes5 s · 720p$1.20/ rodada
Só passe para a configuração de entrega quando estrutura, bordas, contato e continuidade estiverem aprovados; se houver problemas, corrija nesta faixa até ficar satisfeito.
03 / Validação de entrega5 s · 1080p$3.00/ rodada
Use só depois de definir direção e detalhes, para confirmar o resultado final na resolução desejada.

Do teste ao desenvolvimento

Gostou do plano? Leve a mesma configuração para o seu app

Crie uma tarefa de vídeo com o prompt e os parâmetros atuais — sem precisar remontar a requisição a partir da documentação.

1POST /v1/videos
Criar uma tarefa de vídeo
Envie modelo, prompt, duração, resolução e configuração de áudio. Os materiais de referência entram na requisição conforme o modo.
2GET /v1/videos/{id}
Consultar o status da geração
Guarde o ID da tarefa retornado. Consulte até concluir, falhar, ser cancelada ou expirar; não crie a mesma tarefa duas vezes.
3mirror_urls / unsigned_urls
Obter o vídeo
Verifique primeiro o status da tarefa e depois leia a URL do resultado. Prefira mirror_urls; se não houver, use unsigned_urls.

Endpoints e campos seguem os exemplos de código oficiais.

Ler a documentação para desenvolvedores

Que problema cada campo resolve?

Ver todos os campos e exemplos de requisição

O que você quer expressarCampo da OfoxPontos de atenção

Qual modelo usar: model; Nesta página é sempre Seedance 2.5; não use IDs de rota de outras plataformas.
Que ação acontece: prompt; Descreva sujeito, ação, câmera e estado final; tarefas com referência também precisam de descrição.
Duração e configuração de imagem: duration / resolution / aspect_ratio; Nesta página, a duração manual vai de 4 a 30 s; tarefas com primeiro e último quadro usam proporção adaptável.
Fixar o início ou o fim: frame_images; Use first_frame / last_frame para definir o papel de cada quadro; não misture com os campos comuns de referência.
Orientar conteúdo ou estilo: input_references; Referências de imagem, áudio e vídeo não são âncoras exatas de quadro; as restrições seguem o endpoint atual.
Gerar som ou não: generate_audio; Controlado separadamente da qualidade da imagem. Amostras com áudio desativado não significam que o modelo não tenha suporte.
Fixar a plataforma: provider.type; Quando várias plataformas servem o mesmo modelo, as requisições são distribuídas por peso se você não definir isto; para fixar uma plataforma, informe aqui.

Onde a primeira integração costuma travar?

Diferencie “não aceita” de “aceita, mas não concluída”. Depois que a criação retornar um ID de tarefa, consulte primeiro essa tarefa.

Parâmetros ou materiais incompatíveis

Verifique duração, valores enumerados, URLs e tipo de entrada. Primeiro/último quadro e referências comuns usam campos diferentes e não podem ser misturados na mesma requisição.

Problemas de conta ou saldo

Confira a chave do lado do servidor e o saldo disponível. Resolva autenticação e cobrança primeiro e depois tente criar de novo.

A tarefa ainda está aguardando

Guarde o ID e consulte até um status final definitivo, com backoff para evitar polling frequente. Um timeout no front-end não significa que a geração falhou no servidor.

O resultado precisa ser guardado a longo prazo

Depois de obter o vídeo, salve-o no seu próprio armazenamento de entrega. Não trate URLs temporárias de resultado como acervo permanente; confirme que a tarefa foi concluída antes de baixar.

Já usa um fluxo com Agent?

Passe a tarefa completa, não só “gere um vídeo para mim”

Informe objetivo, duração, proporção, a função de cada material, limite de orçamento e critérios de aprovação. Peça ao Agent que mostre primeiro a requisição e o custo estimado, crie a tarefa só depois da sua confirmação, guarde o ID da tarefa e retorne o resultado ou um erro claro.

Este é um briefing copiável; não conecta nenhum Agent nem executa chamadas. As chaves ficam no seu ambiente do servidor.

Dúvidas antes de começar

Perguntas frequentes sobre o Seedance 2.5

Seedance 2.5 na Ofox.ai custa a partir de $0.11 por segundo de vídeo gerado. A tarifa exata depende da resolução, do modo de geração e do áudio. Pague conforme o uso, sem mensalidades.