O modo de amostra do Seedance 2.5 já está disponível na APIYI: guia de invocação em 2 etapas, da amostra em 480p ao vídeo final em 1080p

Nota do autor: este artigo explica o fluxo de chamadas em duas etapas do modo Draft do Seedance 2.5. Primeiro, gere um vídeo de prévia em 480p a baixo custo. Depois de confirmar o resultado, gere a versão final em 1080p. O artigo inclui exemplos de requisições prontos para executar.

Ao gerar vídeos com IA, um dos problemas mais comuns é começar direto pela versão final em alta definição. Se a composição, os movimentos de câmera ou as ações do personagem não ficarem bons, você precisa gerar tudo de novo — desperdiçando tempo e dinheiro. Em 25 de outubro de 2026, a documentação da APIYI ganhou instruções completas de integração do modo Draft do Seedance 2.5. Com esse modo, você pode validar sua ideia primeiro em uma prévia de 480p e, se gostar do resultado, gerar a versão final em 1080p usando o ID da tarefa da prévia.

Esta não é uma API independente. O modo Draft usa a interface assíncrona de tarefas já existente do Seedance. Basta adicionar draft: true ao corpo da requisição ou, na segunda etapa, informar o ID da tarefa da prévia. Se o seu projeto já está integrado ao Seedance, as mudanças necessárias são mínimas.

Principal benefício: ao terminar de ler, você conhecerá o fluxo de chamadas em duas etapas do modo Draft do Seedance 2.5, os principais parâmetros, as regras de cobrança e as limitações de uso. Também poderá integrar o fluxo de trabalho “ver a prévia primeiro, gerar a versão final depois” à sua própria pipeline de produção de vídeos.

Principais pontos do modo de prévia do Seedance 2.5

De acordo com a documentação da APIYI, as informações principais sobre o modo de prévia do Seedance 2.5 podem ser resumidas na tabela a seguir:

Por que vale a pena usar o modo de prévia do Seedance 2.5

A geração de vídeos tem uma diferença marcante em relação à geração de texto: cada geração leva mais tempo, custa mais e tem resultados mais imprevisíveis. Por mais detalhado que seja o comando, o modelo pode interpretar o ritmo dos planos e os movimentos do personagem de um jeito diferente do esperado. Se você gerar tudo diretamente em 1080p, qualquer resultado insatisfatório significa desperdiçar o custo de um vídeo final completo.

O modo de prévia divide o processo em duas etapas: “ensaio” e “gravação oficial”. Uma prévia em 480p já é suficiente para avaliar o personagem ou objeto em cena, a direção dos movimentos de câmera e a atmosfera geral. Depois de confirmar que está tudo certo, você pode gerar o vídeo final em 1080p com base nessa prévia. Para equipes que produzem vídeos curtos, materiais publicitários ou prévias de storyboard em escala, essa abordagem pode reduzir bastante o desperdício com resultados insatisfatórios.

Como funcionam as duas etapas do modo de prévia do Seedance 2.5

Vale lembrar que o vídeo final não é simplesmente uma versão ampliada da prévia. A segunda etapa cria uma nova tarefa de geração, que usa draft_task.id para referenciar a tarefa da prévia, herda as configurações pertinentes dessa etapa e gera o vídeo em 1080p. Para saber quais parâmetros são herdados e quais não podem ser alterados na segunda etapa, consulte a seção “Herança e restrições de parâmetros” da documentação da APIYI.

Comece rapidamente com o modo de prévia do Seedance 2.5

Antes de começar, crie uma chave API no painel da APIYI, em apiyi.com, e defina-a como a variável de ambiente APIYI_API_KEY. Os exemplos abaixo leem a chave da variável de ambiente para evitar que ela fique no código.

Etapa 1: gere uma prévia em 480p

A seguir, veja a requisição mais simples para criar uma tarefa de prévia. O ponto principal é definir "draft": true e a resolução como 480p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进"}
    ],
    "draft": true,
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false
  }'

A chamada à API é assíncrona. Quando a tarefa for criada, você receberá um ID. Guarde esse ID: você vai usá-lo para consultar o resultado da prévia e também para gerar a versão final.

Etapa 1: explicação dos parâmetros da solicitação

O cabeçalho Accept-Encoding: identity solicita que o servidor não comprima a resposta, o que facilita a interpretação dos resultados por alguns clientes. Recomendamos mantê-lo.

Etapa 2: consultar o status da tarefa de geração do vídeo de prévia

Depois de criar a tarefa, consulte o status periodicamente até que ela seja concluída e o endereço do vídeo esteja disponível. A consulta usa a interface existente de tarefas assíncronas. Em geral, basta enviar uma solicitação GET para o endereço da tarefa com o ID correspondente. Consulte a documentação da APIYI para ver o caminho exato e os campos da resposta:

curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Accept-Encoding: identity"

Recomendamos definir um intervalo de 5 a 10 segundos entre as consultas. Consultar com muita frequência não traz benefícios e pode até acionar o limite de requisições.

Etapa 3: gerar o vídeo final em 1080p usando o ID da tarefa do vídeo de teste

Depois de confirmar que o resultado do vídeo de teste está satisfatório, referencie a tarefa usando draft_task.id no array content e defina a resolução como 1080p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

Substitua YOUR_DRAFT_TASK_ID pelo ID da tarefa do vídeo de teste retornado na primeira etapa. Confira na documentação os exemplos de requisição em duas etapas para verificar os valores aceitos pelo campo type do elemento content e os demais parâmetros opcionais. A tarefa do vídeo final também é assíncrona. Consulte o status como na segunda etapa para obter o vídeo em 1080p.

import os
import time
import requests

API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"  # APIYI Seedance 异步任务接口
MODEL = "doubao-seedance-2-5-260628"

HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}


def create_task(payload: dict) -> str:
    """创建异步任务，返回任务 ID"""
    resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
    resp.raise_for_status()
    data = resp.json()
    return data["id"]


def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
    """轮询任务状态，直到成功或失败"""
    start = time.time()
    while time.time() - start < timeout:
        resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
        resp.raise_for_status()
        data = resp.json()
        status = data.get("status")
        print(f"[{task_id}] status = {status}")
        if status == "succeeded":
            return data
        if status in ("failed", "cancelled", "expired"):
            raise RuntimeError(f"任务结束但未成功: {data}")
        time.sleep(interval)
    raise TimeoutError(f"任务 {task_id} 轮询超时")


def generate_draft(prompt: str) -> str:
    """第一阶段：生成 480p 样片"""
    payload = {
        "model": MODEL,
        "content": [{"type": "text", "text": prompt}],
        "draft": True,
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "generate_audio": False,
    }
    task_id = create_task(payload)
    result = wait_task(task_id)
    print("样片结果:", result.get("content"))
    return task_id


def generate_final(draft_task_id: str) -> dict:
    """第二阶段：凭样片任务 ID 生成 1080p 成片"""
    payload = {
        "model": MODEL,
        "content": [
            {"type": "draft_task", "draft_task": {"id": draft_task_id}}
        ],
        "resolution": "1080p",
    }
    task_id = create_task(payload)
    return wait_task(task_id)


if __name__ == "__main__":
    draft_id = generate_draft("一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进")
    ok = input("样片是否满意？(y/n): ").strip().lower()
    if ok == "y":
        final = generate_final(draft_id)
        print("成片结果:", final.get("content"))
    else:
        print("请调整提示词后重新生成样片。")

🚀 Comece rápido: recomendamos resgatar os créditos gratuitos de teste para novos usuários em APIYI apiyi.com. Use vídeos de amostra em 480p para ajustar o comando até obter resultados consistentes e, depois, gere os vídeos finais em 1080p em lote. A plataforma usa uma chave API unificada para cobrança, o que facilita o gerenciamento dos custos de invocação em vários projetos de vídeo.

Comparação entre o modo de amostra do Seedance 2.5 e a geração direta do vídeo final

A escolha de usar o modo de amostra depende do quanto seu negócio prioriza a previsibilidade dos resultados e a velocidade de entrega. A tabela abaixo compara as duas formas de invocação:

Análise comparativa do modo de amostra do Seedance 2.5

A geração direta do vídeo final tem a vantagem de simplificar o processo: basta uma solicitação para obter o vídeo final. Mas, se o assunto principal ou o movimento de câmera não ficarem bons, você perde o valor e o tempo de espera de todo o vídeo final em 1080p. Já o modo de amostra concentra os testes na etapa de baixa resolução, sendo mais adequado para projetos que exigem várias rodadas de ajustes no comando ou a aprovação prévia do cliente.

Se o modelo de comando já foi bastante testado e os resultados são relativamente consistentes, gerar o vídeo final diretamente também é uma boa opção. Uma abordagem prática é usar o modo de amostra para novas ideias e modelos de comando, e a geração direta para modelos já consolidados. É possível alternar entre as duas opções a qualquer momento usando a mesma interface assíncrona.

💡 Recomendação: para comparar os resultados práticos das duas opções, teste algumas variações usando os comandos do seu próprio negócio. Ao fazer as invocações pelo APIYI apiyi.com, os dois modos usam a mesma interface e a mesma chave API. Para alternar entre eles, basta modificar os parâmetros do corpo da solicitação.

Cuidados ao integrar o modo de amostra do Seedance 2.5

Ao integrar o modo de amostra ao ambiente de produção, alguns detalhes podem passar despercebidos. A tabela abaixo reúne os cuidados mais comuns:

Recomendações de fluxo de trabalho para o modo de amostra do Seedance 2.5

Em equipes, recomendamos dividir o modo de amostra em três etapas: “geração — revisão — aprovação”. Depois de gerar amostras em lote, o sistema as envia para revisão. Os IDs das tarefas aprovadas seguem para a fila de geração dos vídeos finais; as reprovadas voltam para a etapa de ajustes no comando, acompanhadas dos comentários da revisão. Assim, as avaliações humanas ficam concentradas na etapa de amostras, que tem custo menor.

Em pipelines mais automatizados, também é possível usar um modelo multimodal na etapa de amostra para fazer uma triagem inicial, verificando, por exemplo, se o sujeito especificado aparece na cena ou se há distorções evidentes. As amostras aprovadas nessa triagem seguem para a revisão humana, reduzindo ainda mais o volume de trabalho. Como a APIYI oferece uma interface unificada para vários dos principais modelos do mercado, a geração de vídeos e a revisão multimodal podem ser feitas com a mesma chave API.

Perguntas frequentes (FAQ)

Pontos-chave do modo de amostra do Seedance 2.5

• Processo em duas etapas: primeiro, use draft: true para gerar uma amostra em 480p; depois, use o ID da tarefa para criar o vídeo final em 1080p
• Interface inalterada: o processo usa a interface assíncrona de tarefas já existente do Seedance, então a integração em projetos já conectados exige poucas mudanças
• Campo principal: na etapa de geração do vídeo final, use content[].draft_task.id para referenciar a tarefa da amostra
• Regras de cobrança: a amostra e o vídeo final são cobrados separadamente. Você só paga pela geração do vídeo final quando aprovar a amostra
• Limite de prazo: o ID da tarefa de amostra é válido por 7 dias; revise e aprove a amostra dentro desse período
• Casos de uso: os benefícios são mais evidentes na exploração criativa, na aprovação pelo cliente e na seleção em lote de materiais
• Como começar: resgate créditos gratuitos na APIYI, em apiyi.com, e siga os exemplos deste artigo para executar o processo completo

Resumo

Principais pontos do modo de prévia do Seedance 2.5:

1. Teste antes de produzir: use prévias em 480p para validar o enquadramento e os movimentos de câmera a baixo custo, reduzindo a taxa de vídeos descartados em 1080p.
2. Integração simples: basta adicionar o parâmetro draft e referenciar draft_task.id, reutilizando a interface assíncrona existente.
3. Atenção à validade e à cobrança: o ID da prévia é válido por 7 dias. A prévia e a versão final são cobradas separadamente.

Se o seu fluxo de produção de vídeos exige ajustes frequentes nos comandos, vale a pena integrar o modo de prévia o quanto antes. Recomendamos começar com alguns comandos representativos e executar o fluxo “prévia → versão final”. Depois de avaliar os resultados e os custos, você pode ampliar o uso para a produção em lote.

Recomendamos usar a APIYI apiyi.com para testar rapidamente os resultados do modo de prévia do Seedance 2.5. A plataforma oferece uma interface compatível com OpenAI, cobrança por uso e créditos gratuitos para testes de novos usuários.

📚 Referências

1. Documentação de geração de vídeos do Seedance 2 da APIYI — modo de prévia: instruções oficiais de uso do modo de prévia do Seedance 2.5
2. Link: docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode

3. Descrição: inclui exemplos de solicitações em duas etapas, herança e limitações de parâmetros, além de informações sobre cobrança e validade.

4. Central de documentação da APIYI: documentação de todas as interfaces de modelos da plataforma

5. Link: docs.apiyi.com
6. Descrição: consulte uma visão geral para escolher entre os modelos Seedance e instruções de uso de outros modelos.

Autor: Equipe técnica da APIYI
Dúvidas técnicas: se encontrar algum problema durante a integração, entre em contato conosco pela página inicial do site da APIYI apiyi.com. Para mais materiais, acesse a central de documentação em docs.apiyi.com.

Artigos relacionados

• Geração e edição prática de vídeos com rostos usando o SeeDance 2.5: cadastre materiais de pessoas reais e faça invocações em conformidade em 3 etapas: Explique claramente o fluxo correto para geração e edição de vídeos com rostos no SeeDance2.5: cadastrar materiais de pessoas reais, obter o Asset ID, fazer a chamada usando a referência asset:// e esclarecer se é necessário “cobrir o rosto” e por que o envio direto de vídeos com rostos é bloqueado.