Seedance API: Preços, Qualidade e Configuração para Endpoints Oficiais

Seedance API: Preços, Qualidade e Configuração para Endpoints Oficiais

A Seedance API é útil quando uma equipe precisa gerar vídeos curtos a partir de texto, imagem ou mídia de referência, mas a decisão de integração não é apenas "qual modelo parece melhor?" Você também precisa escolher um endpoint, entender a unidade de precificação, controlar duração e resolução e medir o custo dos clipes que seus editores ou usuários do produto realmente aceitam.

Este guia se concentra nos caminhos oficiais de configuração que uma equipe de mídia ou produto pode usar hoje:

• A API oficial de tarefa de geração de vídeo do BytePlus ModelArk, que é o caminho direto do provedor para os modelos Seedance.
• A rota /v1/videos da Flatkey, que expõe IDs de modelos Seedance por meio de uma chave de API, um saldo e um catálogo de modelos ao vivo.

A versão curta: use Seedance 2.5 quando precisar de fluxos de trabalho de vídeo guiados por referência mais robustos, áudio opcional e saídas de 4 a 30 segundos. Use Seedance 2.0 Pro, Fast ou Mini quando precisar de uma rota de menor custo por segundo para testes em alto volume e puder manter seu critério de aceitação rigoroso. Sempre compare pelo custo por clipe aceito, não apenas pelo preço por segundo.

Se você ainda estiver comparando a qualidade dos modelos, combine este guia de preços com a estrutura de avaliação da Seedance API. Se estiver comparando rotas de provedores, leia a análise de roteamento e preços da Seedance vs Veo API. Se estiver saindo de testes para operações, mantenha a lista de verificação de produção da Seedance API aberta enquanto configura filas, tentativas e estados de revisão.

Opções de endpoint da Seedance API

O BytePlus ModelArk documenta a Seedance em suas seções de API e preços de geração de vídeo. Sua página de preços descreve os modelos de geração de vídeo como usando uma taxa de token e um modelo de consumo de tokens, e observa que o consumo final de tokens é retornado após a chamada da API por meio de campos de uso. A mesma página de preços também menciona o comportamento de consumo mínimo de tokens para a série Seedance 2.0 e solicitações da Seedance 2.5 quando o uso estimado fica abaixo do mínimo.

As páginas de modelos Seedance da Flatkey apresentam uma unidade mais simples para o comprador nas rotas atualmente no catálogo: preço por segundo, além das opções visíveis de duração e resolução para cada página de modelo. Isso é mais fácil para planejar um orçamento de teste criativo, mas as equipes de produção ainda devem registrar o modelo enviado, a resolução, a duração, o grupo da conta, o status final e o resultado aceito/rejeitado.

Snapshot atual de preços da Seedance API na Flatkey

Os preços abaixo foram verificados nas páginas públicas de modelos da Flatkey em 13 de outubro de 2026. Trate isso como um snapshot de configuração, não como um contrato: sempre confirme a página do modelo ao vivo antes do lançamento ou de uma execução em lote grande.

A tabela fornece uma estimativa inicial. O custo real da campanha depende da duração, resolução, novas execuções, falhas, rejeições de moderação, edições dos usuários e do número de clipes gerados que passam no seu padrão de revisão.

Preço por segundo não é o mesmo que custo criativo

Para um fluxo de trabalho de geração de vídeo, a métrica que importa é:

accepted_clip_cost =
  total_spend_for_generation_batch
  / number_of_clips_that_pass_review

Por exemplo, uma rota que custa menos por segundo ainda pode ser mais cara se produzir muitos clipes que falham na revisão de marca, continuidade ou detalhes do produto. Uma rota com preço mais alto pode ser mais barata quando reduz refilmagens e trabalho editorial.

Use esta planilha simples antes de escolher uma rota da Seedance API:

Escolha de configuração entre Seedance 2.5 e Seedance 2.0

Escolha Seedance 2.5 quando seu fluxo de trabalho depender de mídia de referência, controle de quadros, áudio opcional ou saídas mais longas de 4 a 30 segundos. A página Seedance 2.5 da Flatkey lista fluxos de text-to-video, image-to-video e reference-to-video em /v1/videos, com opções de 480p e 720p e geração de áudio como opção de solicitação.

Escolha Seedance 2.0 Pro quando você precisar de uma rota Seedance 2.0 com opções de resolução visível mais altas na Flatkey e estiver avaliando a qualidade criativa final. Escolha Seedance 2.0 Fast para velocidade de iteração e testes mais amplos. Escolha Seedance 2.0 Mini para triagem de baixo custo, triagem de prompts e exploração inicial de conceitos.

Não troque de modelo apenas com base no preço. Execute primeiro um pequeno conjunto de testes de qualidade:

1. Selecione 20 prompts de briefings reais de campanha.
2. Inclua pelo menos cinco prompts difíceis com detalhes de produto, mãos, embalagem, continuidade de movimento ou alegações sensíveis à marca.
3. Gere a mesma duração e resolução entre as rotas candidatas quando possível.
4. Faça uma revisão cega dos clipes antes de mostrar nomes de modelos ou preços.
5. Acompanhe clipes aceitos, clipes com edições menores, clipes rejeitados, contagem de tentativas, latência de geração e custo final.

Configuração da API Seedance da Flatkey

A rota da Flatkey mantém a configuração compacta porque as páginas públicas dos modelos expõem juntos o ID do modelo e a rota. Comece com uma solicitação pequena e, depois, adicione lógica de armazenamento, repetição e revisão.

export FLATKEY_API_KEY="your_flatkey_api_key"
export FLATKEY_BASE_URL="https://router.flatkey.ai"

curl -sS "$FLATKEY_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "Um vídeo limpo de apresentação de produto em uma mesa de estúdio branca. A câmera se move lentamente da esquerda para a direita enquanto a embalagem gira uma vez. Sem texto, sem marca d'água."
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'

Para image-to-video ou reference-to-video, adicione as entradas de mídia suportadas da página do modelo ou do fluxo de trabalho do console e mantenha a mesma disciplina de registro. Armazene o modelo enviado, o fluxo de trabalho, a versão do prompt, as referências, a resolução, a proporção, a duração, a flag de áudio, o ID da tarefa ou o ID da resposta, o status final, o gasto e o resultado da revisão.

Verificações de configuração do BytePlus ModelArk

Se você usar o BytePlus ModelArk diretamente, siga a documentação atual do ModelArk para criação de chave de API, base URL e autenticação, criação de tarefas de geração de vídeo, recuperação de tarefas, listagem e cancelamento ou exclusão. A forma exata da solicitação e a calculadora de preços devem ser verificadas no console ou na documentação da BytePlus no momento do lançamento.

Use esta lista de verificação antes de um lançamento direto pelo provedor:

• Confirme se o modelo Seedance está ativado na região necessária.
• Confirme se o seu fluxo de trabalho é text-to-video, image-to-video, reference-to-video ou outro modo específico do provedor.
• Confirme se o preço é baseado em tokens, em pacote ou sujeito a uma calculadora para a conta atual.
• Confirme o ciclo de vida da tarefa: criar, consultar ou recuperar, listar, cancelar, excluir e estados de falha.
• Confirme os campos de uso retornados, especialmente o campo usado para o consumo final de tokens.
• Confirme as regras mínimas de consumo de tokens para sua resolução, proporção, duração e modo de entrada de vídeo.
• Confirme a segurança de conteúdo, a retenção de armazenamento e os requisitos de URL de mídia.

A diferença importante é operacional: o ModelArk direto oferece a superfície nativa do provedor, enquanto a Flatkey oferece uma única superfície de conta para vários modelos e modalidades.

Rubrica de qualidade para testes da API Seedance

O preço só se torna útil depois que você define a qualidade. Use uma rubrica que corresponda à forma como sua equipe vai aceitar ou rejeitar clipes.

Para uma equipe de produção, o resultado deste critério deve ser uma regra de roteamento. Por exemplo:

Use seedance-2.0-mini para triagem inicial de prompts.
Use seedance-2.0-fast para exploração mais ampla de conceitos.
Use seedance-2.0-pro quando a qualidade final do 2.0 for importante.
Use seedance-2.5 quando for necessário controle de referência, áudio ou saída de 4 a 30 s.

Configuração de produção: o que registrar desde o primeiro dia

Não espere que os custos o surpreendam para adicionar observabilidade. Registre estes campos desde o primeiro teste da API Seedance:

• request_id ou ID da tarefa
• user_id, workspace, campanha ou conta de cliente
• model
• workflow
• resolution
• ratio
• duration
• generate_audio
• quantidade e tipo de mídia de referência
• versão do prompt enviado
• status da resposta
• código de erro do provedor ou código de erro do gateway
• latência até a saída aceita
• valor cobrado ou uso retornado
• resultado da revisão: aprovado, editado, rejeitado ou com falha

Esses campos permitem que finanças e operações criativas respondam às perguntas reais: qual rota cria clipes utilizáveis, onde ocorrem as reexecuções e se uma rota mais cara é de fato mais barata para um tipo específico de campanha.

Erros comuns na configuração da API Seedance

Os erros mais caros geralmente são operacionais:

• Comparar uma rota de 480p com uma de 720p ou 1080p e chamar isso de diferença de qualidade do modelo.
• Ignorar o comportamento mínimo de duração ou de consumo mínimo de tokens.
• Medir clipes gerados em vez de clipes aceitos.
• Alterar prompt, modelo, duração e resolução ao mesmo tempo durante os testes.
• Tratar texto para vídeo e referência para vídeo como o mesmo fluxo de trabalho.
• Esquecer de acompanhar o tempo de revisão humana e a contagem de reexecuções.
• Fixar um único ID de modelo Seedance sem fallback ou caminho de revisão.

A solução é simples: congele um conjunto de teste, execute configurações comparáveis, registre os campos de rota e custo e, então, escolha a rota com base na saída aceita.

Plano de configuração recomendado

Para uma equipe que está começando esta semana, use esta sequência:

1. Execute 20 prompts em seedance-2.0-mini ou seedance-2.0-fast para avaliar a estrutura do prompt.
2. Promova os melhores prompts para seedance-2.0-pro e seedance-2.5.
3. Compare a taxa de clipes aceitos, não apenas os favoritos visuais.
4. Use seedance-2.5 para clipes com muita referência ou com áudio habilitado.
5. Use uma rota 2.0 de menor custo para exploração ampla quando a taxa de aceitação permanecer boa.
6. Mantenha o mesmo saldo do Flatkey e a mesma superfície de relatórios se seu fluxo de trabalho também usar modelos de imagem, áudio ou texto.

Isso lhe dá uma configuração prática de preços da API Seedance: um caminho de endpoint, escolhas de modelo visíveis, uma planilha de custos e um critério de revisão que mantém a qualidade vinculada ao gasto.

FAQ

O que é a API Seedance?

A API Seedance é uma API de geração de vídeo para criar clipes curtos a partir de prompts e, dependendo da rota selecionada, de imagens ou mídia de referência. No Flatkey, as páginas de modelo Seedance expõem a rota de vídeo por meio de /v1/videos.

Como é calculado o preço da API Seedance?

Nas páginas públicas de modelo do Flatkey, as rotas Seedance atualmente visíveis são apresentadas como preço por segundo, com opções específicas de resolução e duração por modelo. A documentação de preços do BytePlus ModelArk descreve o preço de geração de vídeo por taxa de token e consumo de token, com o uso final sujeito aos campos de uso retornados e a regras mínimas de consumo de token para algumas solicitações Seedance.

Com qual modelo Seedance devo começar?

Comece com seedance-2.0-fast ou seedance-2.0-mini para exploração de baixo custo e, depois, avalie seedance-2.0-pro e seedance-2.5 nos prompts que passarem na revisão. Escolha seedance-2.5 quando precisar dos controles documentados de referência, áudio e fluxo de trabalho de 4 a 30 segundos.

Qual endpoint devo usar para solicitações da API Seedance do Flatkey?

Use POST /v1/videos com o ID do modelo Seedance exibido na página de modelo do Flatkey. As páginas do Seedance 2.5, 2.0 Pro, 2.0 Fast e 2.0 Mini mostram /v1/videos como rota.

O que devo medir em um teste de qualidade da API Seedance?

Meça a aderência ao prompt, a continuidade do movimento, a fidelidade à referência, a segurança da marca, a editabilidade, a latência, a contagem de tentativas e o custo por clipe aceito. O preço por segundo é apenas uma entrada na decisão.

Fontes verificadas

• Página do modelo Flatkey Seedance 2.5: https://flatkey.ai/models/seedance-2.5
• Página do modelo Flatkey Seedance 2.0 Pro: https://flatkey.ai/models/seedance-2.0-pro
• Página do modelo Flatkey Seedance 2.0 Fast: https://flatkey.ai/models/seedance-2.0-fast
• Página do modelo Flatkey Seedance 2.0 Mini: https://flatkey.ai/models/seedance-2.0-mini
• Página de preços da Flatkey: https://flatkey.ai/pricing
• Documentação de preços do BytePlus ModelArk: https://docs.byteplus.com/en/docs/modelark/model-pricing
• Documentação da API de tarefa de geração de vídeo do BytePlus ModelArk: https://docs.byteplus.com/en/docs/modelark/create-video-generation-task-api