Seedance 2.5 API: como usar, parâmetros, limites e custo em créditos

Resposta direta: você pode chamar o Seedance 2.5 pela API do Yovid com uma única chave. Envie POST https://yovid.ai/v1/videos/generations com "model": "seedance-2.5" e um prompt, depois consulte GET /v1/tasks/{task_id} até o status ser completed e leia output.video_url. Os clipes vão de 4 a 30 segundos, e uma requisição pode levar até 30 imagens, 10 vídeos e 10 arquivos de áudio como referência. A cobrança usa os mesmos créditos do Yovid que o site, e os créditos só são debitados quando a tarefa é concluída com sucesso.

Índice

1. De onde vem o acesso à API do Seedance 2.5
2. Início rápido em quatro passos
3. Parâmetros da requisição
4. Como a API escolhe o modo de geração
5. Limites de referências e mídia
6. Quanto custa uma requisição
7. Erros, novas tentativas e limites de taxa
8. Um exemplo completo em Python
9. Perguntas frequentes

De onde vem o acesso à API do Seedance 2.5

O Seedance 2.5 é um modelo da ByteDance Seed. O caminho da própria ByteDance para desenvolvedores passa pelas plataformas de nuvem da empresa: o post de lançamento de 31 de julho de 2026 dizia que o acesso à API chegaria pelo BytePlus ModelArk, reportagens da imprensa dizem que a Volcano Engine abriu o acesso à API na China em 7 de agosto, e a página do Seedance 2.5 da ByteDance aponta para o playground da BytePlus.

O Yovid é uma plataforma independente, sem vínculo com a ByteDance, e oferece o Seedance 2.5 pela própria API:

• Uma chave, uma cobrança. A mesma chave e os mesmos créditos cobrem o Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro e 1.0 Pro Fast.
• IDs públicos estáveis. Você envia seedance-2.5; o Yovid mantém internos os nomes de modelo dos provedores, para que eles possam mudar sem quebrar o seu código.
• A mesma conta do site. Os clipes que você gera pela API usam o plano e os créditos que você já tem.

A referência completa está na documentação da API do Yovid (em inglês); este guia se concentra no que é específico do Seedance 2.5.

Início rápido em quatro passos

1. Crie uma chave de API

Abra Configurações → Chaves de API, dê um nome à chave e crie. O segredo completo aparece uma única vez, então guarde-o em um gerenciador de segredos e carregue-o no seu servidor como YOVID_API_KEY. Nunca coloque a chave em código de navegador ou de app móvel.

2. Crie uma tarefa

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. Consulte a tarefa

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

Consulte a cada 5 a 10 segundos enquanto o status for pending ou processing, aumentando o intervalo aos poucos. Quando ele mudar para completed, a URL do vídeo estará em output.video_url; se mudar para failed, pare de consultar e leia error.

4. Confira seus créditos

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available é o que uma nova tarefa pode usar; reserved fica retido para as tarefas ainda em andamento.

Parâmetros da requisição

A API confere cada valor com o modelo e com o seu plano antes de criar a tarefa e retorna 403 ou 422, com o campo problemático em param, se algo não for permitido. Se você partir de um quadro, a saída segue o formato dessa imagem.

Como a API escolhe o modo de geração

Você nunca envia um modo do provedor. O Yovid escolhe o modo com base na mídia que você anexa:

No modo de referência, cite os arquivos no prompt pela ordem em cada array: @image1, @image2, @video1, @audio1. Uma requisição com referências fica assim:

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

As referências de áudio são um recurso da API: o gerador do site aceita imagens e vídeos, e a API acrescenta até 10 arquivos de áudio para uma voz, uma trilha ou um ritmo.

Limites de referências e mídia

Segundo a página de modelos e entradas da documentação da API:

Toda mídia precisa estar em URLs HTTPS públicas. O Yovid rejeita localhost, endereços de rede privada, URLs com credenciais embutidas e nomes de host que não consegue resolver. Use URLs em vez de Base64; o provedor limita o corpo de cada requisição a 64 MB.

Quanto custa uma requisição

A API cobra nos mesmos créditos do site, com as mesmas tarifas. Pelas tarifas base dos pacotes de créditos, o Seedance 2.5 custa cerca de 3 créditos por segundo em 480p e cerca de 6,1 em 720p, então um clipe de 10 segundos em 720p sai por cerca de 61 créditos e um de 30 segundos por cerca de 183. Assinantes pagam menos por segundo.

• Vídeos de referência são cobrados pela duração do clipe de referência mais a duração da saída, a uma tarifa menor: cerca de 2,1 créditos por segundo em 480p e 4,6 em 720p.
• Desativar o content_filter multiplica o custo por 1,1.
• Primeiro a reserva, depois o débito. Os créditos são reservados quando a tarefa é criada e debitados só se ela for concluída; uma tarefa que falha devolve os créditos.
• Acesso por plano. O Seedance 2.5 exige um plano pago ou um pacote de créditos avulso. Uma conta gratuita recebe 403 plan_upgrade_required.

A tarefa concluída informa o que consumiu em credits_used. Veja a página de preços para planos e pacotes, e o artigo sobre se o Seedance 2.5 é grátis para o jeito mais barato de começar.

Erros, novas tentativas e limites de taxa

Cada chave permite até 120 requisições por minuto, e as consultas contam para esse limite. O endpoint de criação ainda não aceita chaves de idempotência, então não repita um POST automaticamente quando não souber se o primeiro deu certo: isso pode criar uma segunda tarefa e reservar créditos duas vezes. Registre todo task_id que receber.

Um exemplo completo em Python

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

O prompt usa blocos de tempo, o jeito mais confiável de preencher um clipe de 30 segundos. O guia de prompts do Seedance 2.5 traz 13 prompts que você pode enviar do jeito que estão, e as comparações com o Kling 3.0, o Veo 3.1 e o Seedance 2.0 ajudam a escolher qual ID de modelo chamar.

Perguntas frequentes

Existe uma API oficial do Seedance 2.5?

A ByteDance oferece o Seedance 2.5 para desenvolvedores pelas suas plataformas de nuvem, Volcano Engine e BytePlus. A API do Yovid é uma alternativa independente: uma chave e um saldo de créditos para o Seedance 2.5 e os outros modelos Seedance.

Qual é o ID de modelo do Seedance 2.5 no Yovid?

seedance-2.5. Os outros IDs públicos são seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro e seedance-1.0-pro-fast.

Qual pode ser a duração de um vídeo do Seedance 2.5 pela API?

De 4 a 30 segundos por tarefa, definida em duration.

Quais resoluções a API do Seedance 2.5 aceita?

A documentação da API lista 480p e 720p para seedance-2.5. O seu plano também define um teto, e a API retorna 403 antes de criar a tarefa se a qualidade estiver acima dele.

Posso enviar áudio como referência?

Sim, até 10 arquivos MP3 ou WAV em audio_urls, citados no prompt como @audio1, @audio2 e assim por diante. As referências de áudio estão disponíveis apenas pela API.

Uma tarefa que falha consome créditos?

Não. Os créditos são reservados quando a tarefa é criada e debitados só quando ela é concluída com sucesso.

Quantas requisições posso fazer?

Até 120 requisições por minuto por chave, contando as consultas, além de um limite de tarefas simultâneas que depende do seu plano. Uma resposta 429 significa esperar e tentar de novo com backoff.

Quer começar a desenvolver? Crie uma chave em Configurações → Chaves de API e siga o início rápido da API.