A fatura da API de vídeo Seedance raramente é "número de vídeos gerados vezes um preço fixo". Mesmo para um vídeo de cinco segundos, resolução, faixa do modelo, uso de vídeo de entrada, retentativas por falha e armazenamento do resultado alteram o gasto real. Quem faz o orçamento apenas pelo preço de tabela costuma encontrar uma fatura alta depois do lançamento; em geral, o preço unitário não subiu, mas essas variáveis não foram consideradas.

Este artigo divide a cobrança em quatro dimensões: duração, resolução, retentativas e armazenamento. Também apresenta uma fórmula de estimativa, um roteiro de teste e métodos de controle de orçamento. Preços e critérios mudam; consulte a tabela de preços dos modelos e a documentação oficial de cobrança.

Nota: Seedance é um modelo de geração de vídeo do grupo ByteDance; Seedance, Doubao, Volcano Engine, BytePlus e nomes relacionados são marcas de seus titulares (ByteDance e empresas associadas). Este texto é apenas uma explicação técnica e não implica vínculo, representação ou endosso dos titulares. Preços, interfaces e regras de cobrança seguem a documentação oficial e a página de preços do site.

1. Por que a API de vídeo não pode ser orçada "por vídeo"

A unidade de cobrança de APIs de texto é relativamente uniforme; a de APIs de vídeo não é. Por trás de uma requisição de "gerar um vídeo" existem pelo menos quatro variáveis: duração, resolução, faixa do modelo e modo de entrada. Se qualquer uma mudar, a fatura pode mudar.

Pior ainda: enviar uma requisição não significa obter um vídeo utilizável. Rejeição na moderação, timeout e imagens inutilizáveis geram retentativas; quando o link do resultado expira, é preciso gerar de novo ou transferir o arquivo. Orçar apenas por "quantidade vezes preço unitário" subestima o custo de forma sistemática.

2. As quatro dimensões de cobrança

Dimensão Como afeta o custo O que registrar na estimativa Como controlar
Duração Acumula por segundo ou por tokens convertidos; quanto maior, maior o consumo Duração enviada, duração do vídeo final, uso de segmentos Testar com duração curta e montar o vídeo final depois
Resolução O total de pixels cresce com a resolução, muitas vezes somado ao efeito da taxa de quadros Resolução de saída, taxa de quadros, proporção Rascunho em baixa resolução, versão final em faixa superior
Modelo e entrada Faixas e gerações diferentes têm preços diferentes, assim como o modo de entrada Nome do modelo, uso de primeiro quadro ou vídeo de referência Roteamento por dificuldade, sem usar a faixa máxima por padrão
Falhas e retentativas Envios repetidos podem ser cobrados de novo; regras variam por falha Estado da tarefa, código de erro, número de retentativas Classificar erros, idempotência, limitar retentativas
Armazenamento e tráfego Transferência, retenção e distribuição do resultado geram custo extra Tamanho do arquivo, dias de retenção, volume de acesso Limpeza por ciclo de vida, distribuição sob demanda

As gerações mais recentes da série Seedance são medidas em tokens na documentação oficial, com consumo relacionado à resolução, à duração e ao cenário de entrada; alguns gateways convertem a exibição para segundos ou para vídeo. Confirme a unidade da fatura antes de contratar.

3. Como duração e resolução multiplicam o consumo

A duração é a variável mais direta. As faixas comuns são cinco e dez segundos, mas dez segundos não são necessariamente o dobro exato de cinco: algumas plataformas têm unidade mínima de cobrança e outras cobram segundos arredondados. O orçamento deve usar o débito real da fatura, não uma inferência a partir da duração final do vídeo.

O efeito da resolução é mais sutil. De 720p para 1080p, o total de pixels cresce cerca de 2,25 vezes; se a taxa de quadros também subir, o consumo aumenta ainda mais. A fatura final não segue necessariamente essa proporção, porque faixa do modelo, descontos e arredondamento de cobrança também entram. O correto é fixar o prompt e a duração, mudar apenas a resolução e rodar uma comparação, registrando a diferença de débito.

A proporção da tela também afeta o total de pixels. Vertical e horizontal, na mesma "faixa de resolução", podem ter números de pixels diferentes; crie orçamentos separados em vez de usar uma média mensal comum.

4. Por que retentativas e armazenamento costumam ficar fora da conta

Retentativa por falha é a parte do custo de vídeo mais fácil de perder o controle. Erro de parâmetro não deve ser repetido; reenviar repetidamente uma tarefa rejeitada pela moderação normalmente não resolve; apenas limite de taxa e parte dos erros do servidor merecem retentativa com backoff.

Recomenda-se gravar o ID da tarefa no banco, fazer checagem de idempotência antes do envio e reutilizar o mesmo registro de negócio na retentativa. Caso contrário, um laço de script pode enviar dezenas de tarefas idênticas em poucos minutos e produzir uma fatura difícil de explicar.

O custo de armazenamento é frequentemente ignorado. O link do resultado costuma ter validade; depois de expirar, é preciso gerar de novo. Ao transferir para um armazenamento de objetos, surgem custos de armazenamento, de requisição e de tráfego de saída. Recomenda-se transferir após o sucesso e definir regras de limpeza: rascunhos por sete dias, vídeos finais arquivados por projeto e materiais descartados apagados em tempo hábil.

5. Escrevendo o custo por vídeo como fórmula

Um indicador mais confiável do que "preço unitário vezes duração" é o custo por vídeo utilizável:

Custo por vídeo utilizável = (custo das tarefas bem-sucedidas + custo das tarefas que falharam mas foram cobradas + armazenamento e tráfego + revisão humana) ÷ quantidade de vídeos aprovados e prontos para uso

Observe que o denominador é o vídeo final utilizável, não o número de envios. O código Python abaixo faz a conversão; leia os valores da fatura e não os fixe no código:

def cost_per_usable_video(task_costs, usable_count, storage_cost=0.0, review_cost=0.0):
    """task_costs: valor faturado de cada tarefa; usable_count: vídeos utilizáveis"""
    if usable_count == 0:
        raise ValueError("Nenhum vídeo utilizável; verifique prompt, material e parâmetros")
    total = sum(task_costs) + storage_cost + review_cost
    return total / usable_count

# Substitua os placeholders pelos valores exportados da fatura, mantendo a mesma unidade
weekly_task_costs = [0.0] * 40
print(cost_per_usable_video(weekly_task_costs, usable_count=28))

Registre também, nos campos de uso da resposta, o modelo, a duração, a resolução, o estado e o tempo decorrido. Só com critério consistente é possível comparar semanas; não misture dados de canais diferentes.

6. Roteiro padrão para teste em pequena escala

  1. Fixe uma faixa de modelo, uma duração e uma resolução como linha de base.
  2. Prepare de vinte a trinta prompts reais de negócio e imagens de primeiro quadro; não use apenas exemplos que passam sem dificuldade.
  3. Registre tarefa a tarefa o estado, o código de erro, o tempo e o débito na fatura.
  4. Inclua as tarefas com falha no custo total e calcule o custo por vídeo utilizável.
  5. Observe por sete dias, projete o custo mensal pela média diária e acrescente armazenamento, tráfego e horas de revisão.
  6. Mude apenas uma variável por vez, por exemplo subir a resolução uma faixa, para medir a sensibilidade do custo.
  7. Com o resultado, defina a "faixa de teste" e a "faixa de produção" e registre na norma da equipe.

O valor do teste em pequena escala não é apenas obter um número, mas descobrir a qual variável o custo é mais sensível.

7. Práticas concretas de controle de orçamento

  • Uma chave por projeto, com teste e produção separados, para não misturar despesas.
  • Defina teto de gastos por chave no console e configure alertas de uso diário ou semanal.
  • Antes de enviar, faça uma estimativa com os parâmetros atuais; acima de um limite por vídeo, encaminhe para confirmação humana.
  • Limite a concorrência e o número máximo de retentativas, especialmente em scripts em lote.
  • Use baixa resolução em todos os rascunhos; só gere a versão em alta resolução para tomadas aprovadas.
  • Transfira os resultados em tempo hábil, configure ciclo de vida e reconcilie semanalmente por projeto, modelo e resolução.

O gateway normalmente oferece teto por chave, lista de modelos permitidos e exportação de uso; confirme no console. O alerta precisa chegar a uma pessoa responsável; aviso em grupo que ninguém lê é o mesmo que nenhum alerta.

8. Ordem de redução de custos e três erros comuns

A redução deve seguir a ordem de impacto: primeiro elevar a taxa de sucesso, depois cortar retentativas inúteis, em seguida fazer camadas de resolução e cortar duração, depois governar o armazenamento e, por último, considerar trocar de canal. Invertendo a ordem, o resultado comum é preço unitário menor com taxa de falha e custo total maiores.

Três erros comuns:

  1. Olhar apenas o preço de tabela, sem taxa de sucesso e retentativas. Um canal barato que falha com frequência pode ter custo por vídeo utilizável mais alto.
  2. Testar com a duração mais curta e produzir com a duração mais longa e alta resolução; o orçamento não fecha.
  3. Ignorar a validade do link do resultado e gerar de novo após a expiração, pagando duas vezes.

Perguntas frequentes

A API Seedance cobra por chamada, por segundo ou por token?

As gerações mais recentes da série Seedance costumam ser medidas em tokens na documentação oficial, com consumo relacionado à resolução, à duração e ao modo de entrada; alguns gateways convertem a exibição para segundos ou por vídeo. Confirme a unidade da fatura antes de integrar e use a tabela de preços dos modelos como referência.

Subir de 720p para 1080p dobra o custo?

O total de pixels fica cerca de 2,25 vezes maior, mas o débito real também depende da faixa do modelo, da unidade mínima de cobrança e dos descontos; não basta multiplicar por dois. Um teste comparativo com o mesmo prompt é mais confiável.

Tarefas com falha ou rejeitadas pela moderação são cobradas?

As regras variam por plataforma e por motivo da falha. Alguns erros de sistema não são cobrados; outros sistemas cobram a partir da criação da tarefa. Confirme com uma tarefa de teste antes de integrar e inclua o custo das falhas no custo por vídeo.

Por que o teste sai barato e a fatura cresce rápido em produção?

As causas comuns são teste com cinco segundos em baixa resolução e produção com dez segundos em alta definição; aumento de retentativas por falha; custos extras de transferência e distribuição; e chave compartilhada por várias pessoas, sem atribuição. Separe as chaves por projeto e registre a fatura por tarefa.

Como definir um teto de orçamento para geração de vídeo?

No mínimo em três níveis: teto por chave, orçamento por projeto e estimativa antes do envio por tarefa. Ao atingir o limite, pause tarefas não críticas e avise o responsável; não dependa apenas da fatura do fim do mês.

Próximos passos

Crie uma chave de teste no ZSQH AI Gateway, rode de vinte a trinta tarefas na configuração mínima, registre taxa de sucesso, tempo e débito e então projete o orçamento mensal pela tabela de preços dos modelos. Se precisar entender antes o fluxo de tarefas assíncronas, consulte o guia de integração do site.

Leitura relacionada: