Seedance 2.5 API: Guia do Desenvolvedor sobre Endpoints, Autenticação e Geração de Vídeo

Seedance 2.5 API: Guia do Desenvolvedor sobre Endpoints, Autenticação e Geração de Vídeo

A Seedance 2.5 é um modelo de vídeo multimodal de longa duração, o que significa que a API que a aciona é assíncrona, e não uma única requisição-resposta. Você envia uma tarefa de geração, faz polling até a conclusão e baixa o resultado. Depois de entender esse padrão, mais o endpoint, o cabeçalho de autenticação e os campos de payload para duração, resolução e referências, o resto é direto.

Este guia percorre o contrato completo da Seedance 2.5 API: o endpoint, a autenticação, o corpo da requisição, o polling assíncrono e exemplos funcionais em curl e Python. Ele tem como alvo a rota da api-platform da PixMind, que espelha o contrato da ByteDance para o modelo. Também adiciona uma comparação lado a lado com os padrões das APIs Seedance 2.0 e Kling, um estudo de caso de pipeline de produção ponta a ponta, recursos para desenvolvedores de terceiros e um FAQ expandido cobrindo limites de taxa, concorrência, webhooks e verificação de créditos. Todos os detalhes de endpoint e autenticação foram verificados contra o backend ativo em 2026-07-31.

Visão geral do modelo Seedance 2.5

Pontos-chave

• Endpoint: POST /api-platform/v1/generations para criar uma tarefa; GET /api-platform/v1/task/{task_id} para fazer polling do resultado.
• Autenticação: Authorization: Bearer <API_KEY> (ou o cabeçalho X-API-Key); crie uma chave com escopo de vídeo no dashboard da PixMind.
• Payload: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• É assíncrono: a chamada de criação retorna um taskId; você faz polling até status ficar ready e então lê videoUrl.
• Formato entre provedores: Seedance 2.5, Seedance 2.0 e Kling usam todas o mesmo padrão de envio seguido de polling. Diferem no caminho do endpoint, no orçamento de referências e nos nomes dos campos.
• Padrão de produção: adicione um Idempotency-Key na criação, faça polling com tentativas limitadas e backoff, verifique os créditos antes de enviar e tenha uma rota mais barata como fallback para iteração.
• O acesso à API está em breve na PixMind; a rota está documentada e pronta, e a conexão com o backend está sendo finalizada.

Pré-requisitos: Obtenha uma chave de API

As chamadas da Seedance 2.5 são autenticadas com uma chave de API com escopo na sua conta. Crie uma no dashboard da api-platform da PixMind e a armazene de forma segura; trate-a como qualquer segredo. Carregue a chave a partir de uma variável de ambiente no código, em vez de versioná-la no controle de origem:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

Criar uma chave de API

Na PixMind, as permissões da chave são definidas por carga de trabalho (imagem / vídeo). Certifique-se de que sua chave tenha permissão de vídeo habilitada antes de chamar a Seedance 2.5.

Nota do desenvolvedor: Faça rotação de chaves por ambiente (dev / homologação / produção) e limite cada chave ao mínimo de cargas de trabalho de que ela precisa. Uma chave de homologação com escopo apenas de vídeo não vaza para um pipeline de imagem, o que limita o raio de explosão caso a chave seja comprometida. Reemita chaves em uma cadência fixa e registre o carimbo de data/hora do último uso, para que chaves inativas sejam fáceis de encontrar e revogar.

Assista: Walkthrough do fluxo de trabalho da Seedance 2.5

A maneira mais rápida de entender o upgrade da 2.5 antes de escrever código é assistir ao material de demonstração oficial e à análise da comunidade. Estes dois walkthroughs cobrem a geração nativa de 30 segundos, a saída em 4K, a edição em nível de região e o fluxo de trabalho com 50 referências que a API expõe:

Fallback noscript: demonstração da Seedance 2.5 no YouTube, cobre clipes nativos de 30 segundos, edição em nível de região e 50 referências multimodais.

Para uma discussão editorial mais profunda sobre o que os upgrades de fluxo de trabalho significam para um pipeline de produção, a análise "Seedance 2.5 Changes Everything" vale a pena assistir junto com o reel oficial:

Fallback noscript: Seedance 2.5 Changes Everything no YouTube.

O contrato da Seedance 2.5 API

Endpoint

Crie uma tarefa de geração:

POST /api-platform/v1/generations

Faça polling até a conclusão:

GET /api-platform/v1/task/{task_id}

O endpoint de criação é o ponto de entrada unificado de geração: ele lê o campo model e faz o dispatch de acordo. Envie model: "seedance-2.5" e a rota cuida do pipeline de vídeo.

Autenticação

Envie a chave de API como um Bearer token (compatível com o SDK da OpenAI):

Authorization: Bearer $PIXMIND_API_KEY

O middleware de autenticação também aceita o cabeçalho X-API-Key se você preferir esse formato. Ambos são suportados; escolha um e use de forma consistente em todo o código do cliente, para que logs e tentativas sejam mais fáceis de rastrear.

Corpo da requisição

Sobre referências: a Seedance 2.5 aceita até 50 entradas multimodais em uma única requisição, imagens, vídeos, texto e áudio combinados. Dê a cada referência um único papel explícito (identidade, forma, movimento, paleta, ritmo) e remova ativos que concorram para a mesma propriedade.

Como a Seedance 2.5 API se compara a Seedance 2.0 e Kling

A maioria das APIs de vídeo atuais compartilha o mesmo formato assíncrono: um POST para criar a tarefa, um GET para fazer polling até a conclusão. Onde diferem é no caminho do endpoint, na convenção de autenticação, no orçamento de referências e nos nomes dos campos no payload. A tabela abaixo mapeia essas diferenças para as três APIs que os desenvolvedores mais comparam ao planejar uma integração.

Observação em primeira mão: o formato assíncrono compartilhado significa que o código do cliente é reutilizável entre provedores. Envolva o loop de criar e fazer polling em uma única função generate_video(model, payload) e troque o ID do modelo, e você consegue fazer A/B entre Seedance 2.5, Seedance 2.0 Fast e Kling a partir do mesmo harness. Essa é a maneira mais barata de escolher a rota certa por plano sem reescrever o código de integração.

A conclusão prática: se sua equipe já construiu um cliente de polling para a Seedance 2.0, adotar a 2.5 é uma mudança de string do modelo mais os novos campos de referência e duração. Você não precisa redesenhar a integração.

Comparação dos modelos Seedance 2.5 vs Kling

Passo 1: Crie uma tarefa de geração

Aqui está uma requisição de criação mínima, um clipe de 5 segundos, 720p, 16:9 com um prompt em texto. O cabeçalho Idempotency-Key é opcional, mas recomendado para qualquer envio em produção:

curl -X POST https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A courier in a yellow jacket cycling through a neon-lit rainy Tokyo street at night, tracking shot, cinematic, no text",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Uma resposta bem-sucedida retorna um ID de tarefa. Você não recebe o vídeo de volta aqui, você recebe um identificador para fazer polling:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "type": "video",
    "status": "processing"
  }
}

Se você vir code: 400 com "模型不存在或未配置" (o modelo não existe ou não está configurado), a rota do backend para seedance-2.5 ainda não foi habilitada nesse endpoint. Esse é o estado "em breve" na PixMind enquanto a conexão é finalizada.

Passo 2: Faça polling da tarefa até estar pronta

A geração de vídeo é assíncrona. Faça polling do endpoint de tarefa com o taskId do passo 1:

curl -X GET https://aihub-admin.aimix.pro/open-api/v1/task/47264 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

O campo status percorre pending, depois processing e então ready. Faça polling a cada 3 a 5 segundos. Quando a tarefa está pronta, a resposta inclui a URL final do vídeo:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://.../seedance-2-5-47264.mp4",
    "coverUrl": "https://.../seedance-2-5-47264-cover.webp"
  }
}

Os estados terminais de falha são failed, error, canceled e cancelled. Trate-os e exponha o campo description nos seus logs.

Nota do desenvolvedor: Intervalos de polling de 3 a 5 segundos são aceitáveis para uma única tarefa, mas eles se multiplicam rapidamente em escala. Para uma fila de 20 tarefas, prefira um único loop dispatcher que faça polling de cada tarefa aberta uma vez por ciclo, com backoff exponencial (5s, 5s, 10s, 15s, limitado a 30s) conforme as tarefas envelhecem. Isso mantém o volume de requisições educado sem esticar a latência p99 de todo o lote.

Passo 3: Baixe e use o resultado

Quando status for ready, baixe o videoUrl (e opcionalmente o coverUrl para um frame de pôster). O arquivo é um MP4 padrão; transcode, hospede ou incorpore conforme sua aplicação exigir.

Para uma landing page web, você normalmente o comprimiria em um clipe H.264 de 8 a 10 segundos com fast-start para autoplay, extrairia um pôster WebP e hospedaria ambos no seu próprio CDN. (A PixMind hospeda o material de casos da Seedance 2.5 em cdn.pixmind.io.) Não faça hotlink do videoUrl hospedado na API em produção, já que a URL da API não tem persistência garantida.

Exemplo completo em Python

Aqui está um snippet Python completo e executável que cria uma tarefa, faz polling até ficar pronta e imprime a URL do vídeo. Ele adiciona um Idempotency-Key, um loop de tentativas limitado e um limite de timeout, que são as três coisas que um cliente de produção precisa e que um exemplo olá-mundo normalmente omite:

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # escopo: vídeo

GEN = f"{API_BASE}/api-platform/v1/generations"
TASK = f"{API_BASE}/open-api/v1/task"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. Crie com uma chave de idempotência para que uma tentativa não inicie uma segunda tarefa cobrada
payload = {
    "model": "seedance-2.5",
    "prompt": "A 30-second continuous hero shot: a character walking through a neon city that flows into a product reveal",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": True,
}
headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
create = requests.post(GEN, headers=headers, json=payload, timeout=30).json()
task_id = create["data"]["taskId"]
print(f"Task created: {task_id}")

# 2. Faça polling com tentativas limitadas e backoff suave
max_attempts, delay = 100, 5
for attempt in range(max_attempts):
    time.sleep(delay)
    t = requests.get(f"{TASK}/{task_id}", headers=HEADERS, timeout=15).json()
    status = t["data"]["status"].lower()
    print(f"attempt={attempt + 1} status={status} progress={t['data'].get('progress', 0)}%")
    if status in ("ready", "succeeded", "completed"):
        print("Video URL:", t["data"]["videoUrl"])
        break
    if status in ("failed", "error", "canceled", "cancelled"):
        raise RuntimeError(f"Task failed: {t['data']}")
    delay = min(delay + 2, 30)  # backoff, limitado a 30s
else:
    raise TimeoutError(f"Task {task_id} did not finish in {max_attempts * 5}s")

Estudo de caso ponta a ponta: Um pipeline de vídeo de produto de 30 segundos

Esta é a parte que a maioria dos guias de API pula: como uma equipe real costura o contrato acima em um pipeline de produção repetível. O cenário é uma equipe criativa de quatro pessoas em uma marca D2C produzindo um vídeo heroico de 30 segundos para um lançamento de produto, com orçamento fixo e prazo inflexível. O padrão abaixo é o formato que entrega consistentemente no prazo.

Visão geral do pipeline

A equipe divide o trabalho em quatro estágios: iteração (testes A/B baratos na Seedance 2.0 Fast), geração final (uma execução da Seedance 2.5 em 1080p / 30s), revisão e edições de região (regeneração direcionada de região na Seedance 2.5) e entrega (transcode, pôster, upload para CDN). Cada estágio usa o mesmo código cliente; apenas o ID do modelo e o payload mudam. Essa separação é o que torna o pipeline repetível entre campanhas.

Alocação de referências

Antes de qualquer chamada de API, a equipe atribui a cada referência um único papel explícito, capturado em uma planilha compartilhada para que o prompt e o payload permaneçam em sincronia. Cinco referências do orçamento de 50 entradas, cada uma com uma única função:

O prompt mapeia cada uma explicitamente: "mantenha o personagem da @Image 1 inalterado; faça o produto casar com a @Image 2; use @Video 1 apenas para o movimento de câmera; alinhe os cortes a @Audio 1." O mapeamento é o contrato entre a direção criativa e o payload da API. Se uma referência não recebe um papel, ela não entra na requisição.

Estágio de iteração (controle de custo)

Antes de gastar com uma execução de 30 segundos na 2.5, a equipe valida o prompt e as referências na Seedance 2.0 Fast em 5 segundos e 720p. Essa é a mesma chamada POST /api-platform/v1/generations com model: "seedance-2.0-fast". Três iterações custam uma fração de uma execução da 2.5 e revelam conflitos de referência antes que o orçamento seja comprometido. O dispatcher registra em log o taskId, o status e os segundos decorridos de cada iteração, para que o líder criativo possa comparar variantes lado a lado.

Observação em primeira mão: equipes que pulam esse estágio e vão direto para uma geração de 30 segundos na 2.5 tipicamente queimam três ou quatro execuções com preço cheio corrigindo conflitos de prompt que poderiam ter pegado na Fast. O estágio de iteração é a parte de maior ROI do pipeline, e as equipes que entregam de forma confiável são as que o tratam como obrigatório.

Geração final (Seedance 2.5 em 30s / 1080p)

Quando a iteração na Fast confirma que o prompt lê bem, a equipe envia a geração real: model: "seedance-2.5", duration: 30, resolution: "1080p", com as cinco referências anexadas e o prompt completo mapeado por papel. A chamada de criação inclui um Idempotency-Key para que uma tentativa de rede do runner de CI não inicie uma segunda tarefa cobrada. O líder criativo revisa o log final de envio do taskId antes que o dispatcher tenha permissão para confirmá-lo, o que é uma verificação de um minuto que evita erros caros de digitação no prompt.

Polling, erros e idempotência

Um único dispatcher faz polling da tarefa a cada 5 segundos com backoff até 30 segundos, limitando a 100 tentativas (cerca de 8 minutos). Falhas terminais (failed, error) acionam uma única tentativa com um novo Idempotency-Key apenas se a descrição da falha indicar um problema transiente de backend. Erros de referência ou de prompt são repassados ao líder criativo e corrigidos antes do reenvio, não tentados novamente às cegas. O dispatcher escreve uma linha de log estruturada por tentativa (ID da tarefa, status, progresso, segundos decorridos) para que custo e latência sejam auditáveis após o lançamento.

Edições de região

Na revisão, o cliente pede para trocar o produto na prateleira direita do plano final. A equipe envia uma tarefa de edição em nível de região que afeta apenas aquela área, preservando o movimento e a identidade do restante do clipe. Esse é o recurso da 2.5 mais valioso para trabalho cliente: uma ida e volta de um dia vira uma regeneração de 10 minutos. O pipeline mantém o taskId original e o taskId de edição vinculados no log do projeto, para que a linhagem de cada frame entregue seja rastreável.

Entrega

O videoUrl pronto é baixado, transcodificado para H.264 com fast-start para autoplay na web, pareado com um pôster WebP extraído do coverUrl e enviado para o CDN da equipe. Os ativos finais são publicados na landing page e revisados frame a frame (identidade, mãos, geometria do produto, logos, sincronização de áudio) antes da publicação.

Disciplina de custo

O pipeline limita o gasto em três pontos. Primeiro, as execuções de iteração acontecem na Fast em vez da 2.5. Segundo, uma pré-verificação de créditos antes de cada envio na 2.5 aborta se o saldo da carteira estiver abaixo do limite para a duração e resolução escolhidas. Terceiro, um orçamento rígido de tarefas por lançamento no dispatcher recusa-se a enviar novas tarefas assim que atingido. O preço da Seedance 2.5 não é publicado, então a equipe trata qualquer valor por segundo como uma estimativa e lê o gerador ativo para conferir os créditos atuais antes de cada campanha.

Lidando com as 50 referências multimodais

O recurso de manchete, até 50 entradas multimodais, aparece no payload como arrays de URLs públicos:

{
  "model": "seedance-2.5",
  "prompt": "Keep the character from the first image unchanged; use the video for body motion and the audio for rhythm",
  "duration": 20,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_images": ["https://cdn.example.com/character.jpg", "https://cdn.example.com/product.jpg"],
  "reference_videos": ["https://cdn.example.com/motion.mp4"],
  "generate_audio": true
}

Todas as URLs de referência devem ser publicamente acessíveis. Atribua a cada uma um único papel e descreva esse papel no prompt ("use @Video 1 apenas para o movimento do corpo"), para que o modelo saiba qual entrada controla qual propriedade.

Nota do desenvolvedor: Pré-valide se toda URL de referência retorna HTTP 200 com o content-type esperado antes de enviar. Um único 403 em um ativo protegido por CDN é a causa mais comum de tarefas failed em produção, e desperdiça um orçamento inteiro de geração. Uma verificação de HEAD request de duas linhas no seu cliente previne essa classe inteira de falha. Use também URLs estáveis e endereçadas por conteúdo (por exemplo, com um hash ou versão no caminho), de modo que trocar um ativo no meio da campanha não altere silenciosamente o que o modelo recebe.

Tratamento de erros e idempotência

• 401 "API Key 无效" (API Key inválida), chave incorreta ou a chave não tem escopo de vídeo. Verifique a chave e suas permissões.
• 400 "模型不存在或未配置" (o modelo não existe ou não está configurado), a rota seedance-2.5 não está habilitada nesse backend ainda. Na PixMind esse é o estado "em breve".
• 4001 "余额不足" (saldo insuficiente), a requisição é válida, mas sua carteira não tem créditos; a tarefa não é criada.
• 429 limite de taxa, faça backoff exponencial e tente novamente; o endpoint de criação impõe limites de concorrência e de taxa de requisição por chave. Se você atingir isso com regularidade, contate o suporte para elevar os limites ou espace envios em intervalos curtos.
• 502 / 504 gateway, transiente; refaça a chamada de criação com o mesmo Idempotency-Key para que o backend deduplique e você não inicie uma segunda tarefa cobrada.
• Timeout de polling, limite as tentativas (por exemplo 100 × 5s, cerca de 8 minutos) e trate o timeout como uma falha com uma única tentativa.

Para produção, envie um cabeçalho Idempotency-Key em toda chamada de criação, para que uma tentativa do cliente não inicie uma segunda tarefa cobrada. Use um UUID por tarefa lógica (não por tentativa HTTP), gerado uma vez e armazenado do seu lado, para que a mesma geração lógica seja deduplicada entre tentativas, reexecuções de CI e replays de fila. O padrão é: gerar o UUID quando o usuário (ou o job runner) decide criar a tarefa, persisti-lo antes da primeira chamada HTTP e reutilizá-lo em toda tentativa dessa mesma tarefa lógica.

Recursos para desenvolvedores de terceiros

O contrato acima é o caminho de implementação na PixMind. Para um contexto mais profundo sobre o modelo subjacente da ByteDance e a superfície oficial da API, estes são os recursos que os desenvolvedores mais buscam, verificados em 2026-07-31:

• Página de recursos da Seedance 2.5 na BytePlus, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. O enquadramento da própria ByteDance para a 2.5, orientado em torno da geração de vídeo publicitário e demos de produto. Útil para a narrativa de capacidades e os casos de uso que a própria ByteDance visa. Listagem verificada em 2026-07-31.
• Documentação da API BytePlus ModelArk, a superfície oficial de desenvolvedor para invocar a Seedance pela nuvem da ByteDance. Referencie nomes de campos e modos quando precisar confirmar o que a rota conectada expõe, e então espelhe esses nomes no seu cliente.
• Documentação da Volcengine 火山方舟 (Volcano Engine Ark), volcengine.com/docs/82379. O endpoint doméstico (China) para a mesma família de modelos. O padrão assíncrono de envio e polling é o mesmo da rota PixMind; nomes de campos e fluxo de autenticação diferem um pouco. Listagem verificada em 2026-07-31; confirme o caminho ativo antes de integrar.
• Guia de recriação da demo da MakeFun AI, makefun.ai/seedance-2-5-demo-videos/. Percorre a recriação dos fluxos de trabalho pesados em referência da BytePlus ModelArk. Útil quando você quer reproduzir o look oficial antes de projetar seu próprio prompt.
• Análises da comunidade, a análise da 2.5 no Topview/Medium, a cobertura FORCE da Pixo e o guia completo da ToSea cobrem os upgrades de fluxo de trabalho sob um ângulo editorial. Úteis para contexto, não para detalhes de endpoint; sempre confirme especificidades técnicas contra a API ativa.

Nota do desenvolvedor: Guias de terceiros envelhecem rápido. Trate qualquer um deles como ponto de partida e confirme caminhos de endpoint, nomes de campos e custos de crédito contra a rota conectada no dia em que você integrar. Os detalhes de endpoint e autenticação deste guia foram verificados em 2026-07-31, mas o modelo ainda está em implantação, então reconfirme antes do lançamento em produção.

Perguntas frequentes sobre a Seedance 2.5 API

Qual é o endpoint da Seedance 2.5 API?

Crie uma tarefa com POST /api-platform/v1/generations e então faça polling de GET /api-platform/v1/task/{task_id} até status ficar ready. O campo de modelo é seedance-2.5.

Como faço para me autenticar na Seedance 2.5 API?

Envie sua chave de API como Authorization: Bearer <key>. O cabeçalho X-API-Key também é aceito. Crie uma chave com permissão de vídeo no dashboard da PixMind e a carregue a partir de uma variável de ambiente em vez de embuti-la no código-fonte.

A Seedance 2.5 API está disponível na PixMind?

A rota está documentada e pronta; o acesso ao backend está sendo finalizado e o modelo está marcado como "em breve". A página /api-platform/models/seedance-2-5 tem a referência de endpoint e parâmetros, e a página /ai-video/seedance-2-5 hospeda o gerador web no período intermediário.

Quantas referências posso enviar em uma requisição da Seedance 2.5?

Até 50 entradas multimodais, imagens, vídeos, texto e áudio combinados, em uma única requisição. Isso subiu de 9 na Seedance 2.0. Toda referência precisa ser uma URL publicamente acessível.

A Seedance 2.5 API retorna o vídeo de forma síncrona?

Não. A geração de vídeo é assíncrona. A chamada de criação retorna um taskId; você faz polling do endpoint de tarefa até status ficar ready e então lê o videoUrl. Uma geração típica de 30 segundos leva vários minutos, então desenhe seu cliente para polling, e não para bloqueio.

Quais são os limites de taxa e os limites de concorrência?

O endpoint de criação impõe limites de taxa de requisição e de concorrência por chave. Se você excedê-los, a resposta retorna 429 e você deve fazer backoff exponencial. Para cargas de lote (mais do que algumas tarefas concorrentes), espace envios em intervalos curtos e contate o suporte para elevar os limites se você atingir 429 com regularidade. Os limites numéricos exatos são ajustados por conta, então verifique-os na sua própria chave antes de planejar um grande trabalho em lote.

A Seedance 2.5 API suporta webhooks ou callbacks?

A rota verificada da PixMind usa apenas polling, e não callbacks de push. Se sua arquitetura precisa de notificações de push, rode um único dispatcher que faça polling do endpoint de tarefa e emita um webhook para seus serviços downstream quando status alcançar um estado terminal. Isso mantém a integração simples e evita acoplar seu pipeline a uma URL de callback que pode mudar entre ambientes.

Quantas tarefas concorrentes posso rodar?

A concorrência é limitada pelos limites por chave da sua chave e pelo seu saldo de créditos. Para trabalhos em 1080p de 30 segundos, espere rodar algumas tarefas em paralelo em vez de dezenas. Trate o limite ativo como verificado-na-sua-conta: envie um pequeno lote de calibração, meça quantas tarefas saem de pending para processing simultaneamente e dimensione sua fila contra esse número.

Qual formato de vídeo a API retorna?

A tarefa pronta retorna um videoUrl apontando para um arquivo MP4 padrão, mais um coverUrl para um frame de pôster. Baixe e transcode para o formato que seu alvo de entrega precisa (H.264 com fast-start para web, encodings verticais para social, ProRes para masterização de edição). Não faça hotlink do videoUrl hospedado na API em produção porque ele não tem persistência garantida; copie o arquivo para o seu próprio CDN quando o status for ready.

Como faço para verificar os créditos antes de enviar?

Leia o gerador ativo para o custo atual de créditos na sua duração e resolução escolhidas e então verifique o saldo da sua carteira. A API retorna 4001 "余额不足" (saldo insuficiente) se o saldo estiver muito baixo, ponto em que a tarefa não é criada. Para pipelines de produção, adicione uma verificação de saldo pré-envio que aborta cedo se o saldo estiver abaixo do limite por tarefa, para que você não enfileire trabalho que a carteira não consegue cobrir.

Como faço para corrigir o erro "模型不存在或未配置" (o modelo não existe ou não está configurado)?

Essa resposta 400 significa que a rota seedance-2.5 não está habilitada no endpoint de backend que você está atingindo. Na PixMind esse é o estado "em breve" enquanto a conexão de backend é finalizada. Confirme que você está chamando o caminho documentado /api-platform/v1/generations com model: "seedance-2.5" (minúsculas, exato). Se ambos estão corretos e o erro persiste, a rota ainda não está aberta na sua conta; monitore a página /api-platform/models/seedance-2-5 quanto à disponibilidade.

Quais resoluções e durações posso solicitar?

Durações de até 30 segundos em um único tiro; resoluções de 480p, 720p, 1080p e 4K nativo. Confirme as opções exatas no gerador ativo antes de enviar, já que a rota conectada pode expor apenas um subconjunto.

O preço da Seedance 2.5 API está publicado?

Ainda não. Trate qualquer valor por segundo que você veja em outro lugar como uma estimativa. Leia o gerador ativo para os créditos atuais na sua duração e resolução escolhidas antes de enviar, e estruture seu pipeline para que ele possa absorver uma atualização de preço sem reescrever a integração.

Comece a construir com a Seedance 2.5 API

A Seedance 2.5 API é um contrato padrão de geração de vídeo assíncrona: uma chamada de criação, um loop de polling, um download. Depois que você tem uma chave com escopo de vídeo, os exemplos em curl e Python acima são tudo o que você precisa para enviar uma primeira integração. A tabela de comparação e o estudo de caso de pipeline mostram como escalar esse contrato de um único clipe para um fluxo de trabalho de produção repetível que sobrevive a edições do cliente, pressão de orçamento e prazos.

→ Leia a referência completa da rota da Seedance 2.5 API, ou experimente o modelo no gerador web enquanto o acesso à API está sendo finalizado.

Compare todas as rotas Seedance

Detalhes de endpoint e autenticação verificados contra o backend da api-platform da PixMind em 2026-07-31. Links de recursos de terceiros verificados em 2026-07-31. Campos da comparação com a API Kling estão marcados como estimativa e devem ser confirmados contra os docs ativos da Kling. O preço da Seedance 2.5 não é publicado e está marcado como apenas estimativa.