APIMart
Acesso e preços da API Doubao Seedance 2.5

Acesso e preços da API Doubao Seedance 2.5

Saiba como acessar a API Doubao Seedance 2.5, comparar opções de preço, estimar custos de vídeo e criar com segurança um workflow assíncrono.

Tutorial

Ao avaliar o Seedance 2.5 hoje, eu observaria primeiro três pontos: o acesso ainda é limitado, parte dos preços depende de estimativas e a configuração segue principalmente um fluxo assíncrono de trabalhos de vídeo.

Esta é a versão resumida:

  • Fora da China continental, posso acessar a API pelo BytePlus ModelArk; na China continental, pelo Volcano Engine Ark; ou usar a APIMart para um cliente no padrão OpenAI.
  • A cobrança deve ser em USD no BytePlus e na APIMart e em CNY no Volcano Engine Ark.
  • Os preços públicos do Seedance 2.5 ainda não foram divulgados por completo. O planejamento atual usa taxas de referência do Seedance 2.0, como $0.092/seg. em 480p e $0.199/seg. em 720p.
  • A conta básica é segundos × taxa por segundo. A cerca de $0.20/seg., um clipe de 10 segundos custa aproximadamente $2.00 e um de 30 segundos, cerca de $6.00.
  • A integração é direta: enviar trabalho → consultar status a cada 8–15 segundos → baixar ao concluir.
  • O principal atrativo é a entrada multimodal no mesmo fluxo, com até 50 ativos de referência, além de controles de vídeo, áudio e edição.

Em outras palavras, se já existe um sistema de trabalhos no backend e é necessário gerar vídeos curtos e guiados, o Seedance 2.5 parece adequado. Antes de definir orçamento ou lançar, eu verificaria acesso atual ao modelo, ID de modelo vigente e preços reais no console.

Fluxo da API Doubao Seedance 2.5: enviar, consultar e baixar
Fluxo da API Doubao Seedance 2.5: enviar, consultar e baixar

Guia completo de integração da API Seedance 2.5

Visão geral da integração da API Seedance 2.5

Comparação rápida

RotaMelhor opção paraCobrançaConfiguração de acessoEstilo da API
BytePlus ModelArkEquipes fora da China continentalUSDConta BytePlusAPI própria
Volcano Engine ArkEquipes na China continentalCNYConta empresarial + KYCAPI própria
APIMartEquipes que querem um único padrão de clienteUSDCadastro por e-mailCompatível com OpenAI

Agora veremos a parte mais importante: como obter acesso, quanto um clipe pode custar e como conectá-lo a um aplicativo sem desperdiçar tempo ou orçamento.

1. O que o Doubao Seedance 2.5 oferece

Principais recursos multimodais e de vídeo

O Seedance 2.5 reúne grandes melhorias em uma única execução: saída 4K nativa, HDR de 10 bits, geração de vídeos mais longos e forte controle por referências. A saída chega à resolução 4K nativa com profundidade de cor HDR de 10 bits, adequada a publicidade e pré-visualização cinematográfica.[2][5]

Para usuários de API, o destaque é o sistema multimodal de referências. Uma geração aceita até 50 entradas multimodais de referência, como imagens, clipes de vídeo, arquivos de áudio, modelos 3D e esboços CAD. Isso faz diferença quando personagens, produtos ou estilos visuais precisam permanecer consistentes em várias tomadas. O Seedance 2.5 também permite mascarar uma área, como logotipo ou fundo, e substituí-la sem renderizar o clipe inteiro.[5][13]

Ele também gera áudio junto com o vídeo, incluindo diálogos, sincronização labial e sons ambientes. Assim, equipes testam ideias e revisam clipes sem adicionar imediatamente uma etapa separada de pós-produção.[13][8]

Relatos indicam uma melhora de aproximadamente 20% na fidelidade ao prompt em relação ao Seedance 2.0.[13]

Esses recursos definem a próxima decisão: qual rota de acesso usar e quanto reservar.

O papel do Seedance 2.5 no ecossistema Doubao

O Seedance 2.5 também está disponível no Jimeng AI e no Doubao Pro para uso sem API.

Para desenvolvedores, o acesso à API ocorre pelo BytePlus ModelArk fora da China continental e pelo Volcano Engine Ark dentro dela. Atualmente, o acesso está limitado ao beta empresarial.[2][3][10][11] Nessas configurações, o Seedance 2.5 funciona como modelo chamável em uma plataforma de nuvem, que gerencia autenticação, cotas, monitoramento de trabalhos e logs.[12][4]

Rotas de API, inclusive opções unificadas como a APIMart, também oferecem controles mais precisos, como edições por região e grande capacidade de referências.[11][12][4] A próxima seção explica como solicitar acesso e os requisitos de cada rota.

Compare agora as opções de acesso, onboarding e cobrança.

2. Como obter acesso à API

Acesso oficial pelo BytePlus ModelArk e Volcano Engine Ark

Configuração de acesso ao BytePlus ModelArk

A ByteDance oferece duas rotas próprias de API. A escolha depende principalmente de onde sua equipe opera.

O BytePlus ModelArk é a opção internacional para equipes fora da China continental. A cobrança é em USD e a documentação está em inglês.[22][23][24] A configuração é direta: crie uma conta BytePlus, ative o ModelArk no console, habilite o modelo Seedance e gere uma chave de API. Depois, use o endpoint regional exibido no console com o ID do modelo Seedance 2.5 vinculado à conta.

O Volcano Engine Ark (火山方舟) segue caminho parecido, mas atende operações na China continental. Crie uma conta empresarial, ative o Ark, gere uma chave e chame o endpoint regional com autenticação Bearer. A cobrança é em CNY e exige verificação empresarial, inclusive KYC.[6][20][21]

Há uma ressalva: o acesso ao Seedance 2.5 ainda está sendo liberado. Mesmo quando IDs públicos estão listados, talvez 2.5 ainda não apareça. Confira o ID atual no console antes de integrar à produção.[2][3]

Depois de escolher a rota, resolva cobrança e formato da solicitação.

Acesso unificado pela APIMart

Acesso unificado à API pela APIMart

Se você prefere um único padrão de cliente para vários modelos, a API unificada simplifica o trabalho.

A APIMart oferece uma API compatível com OpenAI para modelos de vídeo, imagem e linguagem, com uma chave e uma URL base.[1][16][17] Para começar, crie uma conta APIMart, gere uma chave no padrão OpenAI, direcione o cliente HTTP ou SDK compatível para https://api.apimart.ai/v1, e envie solicitações ao endpoint unificado videos/generations com o ID desejado.[17][18][14][15]

Como a interface segue o esquema OpenAI, equipes que já o usam para modelos de linguagem podem adicionar vídeo sem alterar autenticação nem reconstruir a lógica. Em resumo: mesmo padrão, novo modelo. Mantenha o ID flexível durante o lançamento do Seedance 2.5.

Comparação de rotas: onboarding, cobrança e estilo da API

Use a tabela para comparar região, cobrança e cliente.

RecursoBytePlus ModelArkVolcano Engine ArkAPIMart
Foco geográficoInternacionalChina continentalGlobal / equipes dos EUA
Requisitos da contaConta BytePlusConta empresarial + KYCCadastro padrão por e-mail
AutenticaçãoChave de APIToken BearerToken Bearer compatível com OpenAI
Moeda de cobrançaUSDCNYUSD

3. Como os preços funcionam na prática

Preço por segundo, cobrança por tokens e fatores de custo

Depois da escolha da rota, o preço vira uma tarefa de orçamento. O preço do Seedance 2.5 varia: o BytePlus ModelArk cobra por segundo em USD, enquanto o Volcano Engine Ark cobra por milhão de tokens em CNY. As taxas também mudam quando há entrada de vídeo.[9][7]

Quatro fatores definem a maior parte da conta. A duração da saída é o principal. Um clipe de 30 segundos custa cerca de seis vezes mais que um de 5 segundos na mesma taxa. Depois vem a resolução. Os preços do Seedance 2.0 no ModelArk indicam 720p Standard a $0.199/seg. e 480p Standard a $0.092/seg..[9] Áudio e vídeo de referência também podem elevar o custo.

O Seedance 2.5 ainda não tem uma taxa pública oficial. Trate os números atuais como estimativas e consulte o preço ao vivo no console antes de se comprometer.[25][10]

Exemplos de orçamento para equipes dos EUA

A estimativa mais simples é:

custo da renderização = segundos × taxa por segundo

Duração~$0.10/seg. (480p)~$0.20/seg. (720p)~$0.23/seg. (720p, estimativa superior)
5 segundos$0.50$1.00$1.15
10 segundos$1.00$2.00$2.30
15 segundos$1.50$3.00$3.45
30 segundos$3.00$6.00$6.90

Para previsões mensais, use:

renderizações por dia × média de segundos por renderização × taxa por segundo × dias por mês

Na prática, uma equipe de marketing que cria 20 clipes curtos por dia, com média de 8 segundos, a $0.20/seg., gastaria aproximadamente $960/mês. Uma equipe de produto com 5 demonstrações longas por dia, de 30 segundos cada, gastaria cerca de $900/mês na mesma taxa. Resolução maior, áudio ou referências de vídeo aumentam esses valores. Reserve também orçamento para tentativas e versões extras.

Com os gastos mapeados, escolha o fluxo da solicitação e o formato de entrada.

Como os preços da APIMart ajudam a verificar custos do Seedance

Use os preços publicados do Seedance na APIMart para estimar o gasto por clipe e confirme com um pequeno lote antes da produção.

4. Como integrar o Doubao Seedance 2.5 a um aplicativo

Fluxo básico com clientes REST e workflows compatíveis com SDK

Com acesso e preço definidos, a integração consiste em um loop assíncrono simples e uma configuração cuidadosa das entradas.

O fluxo é previsível: envie um trabalho, consulte o status e armazene a saída ao concluir. Use o mesmo padrão em cada solicitação: autentique com token Bearer, envie a geração com POST, consulte o ID a cada 8–15 segundos[19] e baixe o vídeo assim que o status mudar para succeeded.

Mantenha a chave em uma variável de ambiente no servidor. Nunca a coloque no código do cliente.

Na APIMart, você pode manter o código do SDK compatível com OpenAI e alterar somente a URL base e o modelo. É um bom atalho para workflows existentes.

Status do trabalhoSignificadoAção
queued / pendingAguardando recursosContinuar consultando
runningGeração em andamentoAguardar, sem reenviar
succeededVídeo prontoBaixar video_url imediatamente
failedOcorreu um erroRegistrar e investigar antes de repetir
expiredRegistro expirouRevisar o registro do trabalho

Teste primeiro com cURL. Depois, transfira a lógica para um módulo de serviço com tentativas e tratamento de erros compartilhados.

Em erros, aplique backoff exponencial a respostas 429, que indicam limite de taxa. Não repita automaticamente 400, 401 ou 402. Elas costumam indicar solicitação inválida, autenticação ou cobrança e exigem análise manual.

Entradas para geração por texto, imagem e referências

Depois de configurar o loop, defina prompts e ativos de origem que determinam a qualidade.

Comece com quatro entradas:

  • Estrutura do prompt
  • Ativos
  • Duração
  • Resolução

Para prompts, use Sujeito → Ação → Câmera → Cenário → Clima. O formato dá uma base repetível. Em campanhas com muitos produtos, uma biblioteca por campanha ou tipo economiza tempo e reduz tentativas.

Crie rascunhos primeiro em 480p ou 720p. Depois, execute novamente em 1080p ou 4K para a exportação final. Assim, os testes iniciais ficam leves e problemas aparecem antes do gasto maior.

Formato e duração devem corresponder ao canal. Para redes sociais, vídeos verticais 9:16 de 5–15 segundos atendem aos limites comuns. Em lojas de e-commerce, 10–30 segundos em 16:9 ou 1:1 costumam funcionar melhor.

O Seedance 2.5 aceita até 50 arquivos multimodais de referência em uma solicitação.[26] Em produção, armazene-os com versionamento e use URLs estáveis. Adicione metadados como ID do produto, campanha e região para rastrear quais entradas geraram cada saída. Assim, é fácil responder qual conjunto de imagens criou uma versão.

Casos de uso para equipes de produto e empresas

As escolhas variam conforme o trabalho.

Equipes de e-commerce podem transformar imagens de catálogo em vídeos em escala e enviá-los para revisão antes da publicação.

Equipes de marketing podem criar variantes regionais de um conceito trocando idioma do prompt e referências. A mesma ideia para outro mercado.

Equipes de educação e pré-produção podem enfileirar lotes durante a noite e revisar as saídas depois. O bloqueio com modelo branco 3D do Seedance 2.5 ajuda direção e arte a planejar a composição antes de produzir ativos finais.

Uma regra deve permanecer: chamadas à API Seedance ficam atrás do backend. O servidor envia, consulta e armazena. O frontend lê somente dados internos de status e URLs finais.

Conclusão: escolha da rota de acesso e integração

O Seedance 2.5 é uma API multimodal de vídeo para workflows programáticos. Ele atende equipes criativas e de produto que precisam gerar vídeo por texto, imagem e referências em escala.

Com o caso de uso definido, escolha a rota que corresponde à região, conformidade e cobrança. Em termos simples, use a opção alinhada à operação e ao local de implantação.

O planejamento de custos depende principalmente da duração do clipe. Uma estimativa simples é:

duração do clipe × volume mensal × taxa por segundo

Também é útil acompanhar separadamente piloto, produção e desenvolvimento. Isso facilita a leitura e impede que testes distorçam os números de produção.

Comece pequeno. Use um endpoint, um prompt e um clipe. Adicione logs e monitoramento conforme o uso crescer.

Perguntas frequentes

Como confirmar se o Seedance 2.5 está ativo na minha conta?

Verifique no painel da APIMart ou na página de gerenciamento de chaves se o Seedance 2.5 está habilitado no escopo atual.

Como é um modelo recente, o acesso varia por região ou nível da conta. Se a solicitação retornar 403 Forbidden, a chave não tem permissão para usar o Seedance 2.5.

Qual orçamento devo reservar para o primeiro lote de testes?

Use os preços do Seedance 2.0 como referência. O Seedance 2.5 deve seguir um modelo semelhante de cobrança por segundo, com estimativa de $0.10 a $0.20 por segundo para saída 480p ou 720p.

Para controlar gastos, comece com rascunhos de baixa resolução. Reserve renderizações 1080p ou 4K para a versão final. Esse workflow evita desperdiçar dinheiro em testes.

Considere também os custos de clipes de referência, que podem elevar o total em cerca de 50% da taxa de saída por segundo.

Qual backend é necessário antes da integração?

Use um backend seguro no servidor em todas as solicitações. Nunca exponha chaves no cliente, controle de versão ou imagens de contêiner. Armazene-as em um gerenciador de segredos ou variável de ambiente e injete-as em runtime.

O backend também deve incluir logs de auditoria e um workflow assíncrono idempotente. Ele envia solicitações, armazena o ID, consulta até concluir e move o vídeo para armazenamento durável ou CDN antes que a URL expire.

Pronto para testar?

Escolha o modelo que você quer no marketplace

Teste modelos de chat, imagem e vídeo no marketplace da APIMart e experimente rapidamente as capacidades dos modelos com uma API unificada.

Modelos de chatModelos de imagemModelos de vídeo
Explorar marketplace