Introdução
Extensão de vídeo com Seedance 2.5. Envie o clipe que você quer continuar e um prompt sobre o que acontece depois: no máximo os últimos 30 segundos vão para o Seedance 2.5 reference-to-video como vídeo de referência, então o novo trecho retoma o movimento, a câmera e o som do final. O clipe completo e o novo trecho voltam unidos em um único MP4. Você paga só os segundos de referência e os segundos novos.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
| Endpoints | text-to-video, image-to-video, reference-to-video |
| Duração do clipe | 4 a 30 segundos inteiros, padrão 5 |
| Resolução | 480p, 720p (padrão), 1080p |
| Proporção | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive (padrão); só adaptive no image-to-video |
| Áudio | Trilha nativa renderizada na mesma passada, ligada por padrão |
| Referências | Até 30 imagens, 10 vídeos, 10 faixas de áudio — só no reference-to-video |
Recursos e destaques
O som volta no mesmo arquivo do vídeo
generate_audio já vem ligado, então a trilha sai da mesma passada que os quadros em vez de ser colada depois. O passo cai junto com o pé, a frase sussurrada fica na boca de quem fala e a sala continua atrás das duas coisas. Desligue quando o clipe vai para um sound designer de qualquer jeito.
Trinta referências pra um plano só
O reference-to-video aceita até 30 imagens, 10 clipes e 10 faixas de áudio numa requisição só. Três ângulos do mesmo rosto seguram um personagem ao longo de uma série muito melhor que trinta quadros sem relação entre si; os clipes de referência levam movimento e ritmo, e o áudio de referência dá ao corte um lugar para cair. É um endpoint separado e não aceita primeiro quadro.
Primeiro quadro, último quadro e trinta segundos no meio
O image-to-video prende a abertura numa imagem que você envia. Some last_image_url e o plano passa a ter obrigação de chegar em algum lugar específico — é isso que torna transições, revelações e pares antes/depois repetíveis. Depois de uns dez segundos uma tomada única começa a derivar, então vários takes curtos montados em sequência costumam segurar melhor que um take longo.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório. Descreva o que acontece depois: a ação seguinte, o movimento de câmera e o som. |
video_url | Sim | O clipe a continuar: MP4, MOV ou WebM, de 2 a 60 segundos. pelo menos 1 caracteres |
resolution | Não | Tamanho do novo trecho: 480p, 720p ou 1080p, padrão 720p. Define só a qualidade do novo trecho, então escolha o ajuste do seu clipe. |
duration_seconds | Não | Duração do novo trecho: qualquer número inteiro de 4 a 30, padrão 5. |
generate_audio | Não | Ligado por padrão: o novo trecho ganha som gerado que acompanha a referência. Valor padrão: |
enable_web_search | Não | Desligado por padrão. Ligado, o modelo pode buscar na web informações ligadas ao prompt antes de gerar o novo trecho. Valor padrão: |
seed | Não | De 0 a 2147483647. Mantenha fixo para comparar mudando um campo por vez; deixe de fora para ter variedade. |
watermark | Não | Desligado por padrão. Ligado, o novo trecho recebe uma marca d’água indicando conteúdo gerado por IA; o seu clipe não é alterado. Valor padrão: |
Preços
Cobrado por segundo de material de referência mais o novo trecho, pela tarifa do Seedance 2.5 reference-to-video com vídeo de referência para a resolução e a configuração de som escolhidas. A referência são no máximo os últimos 30 segundos do seu clipe, arredondados para segundos inteiros, e vale o mínimo do Seedance (um trecho de 5 segundos cobra pelo menos 4 segundos de referência). As partes anteriores do clipe não são cobradas. Para um link que não conseguimos medir antes, reservamos 30 segundos de referência e liberamos o que não for usado na liquidação.
| Resolução | With video: Sim | With video: Não |
|---|---|---|
| $0.0738 / segundo | $0.1234 / segundo |
| $0.1659 / segundo | $0.2773 / segundo |
| $0.4082 / segundo | $0.6823 / segundo |
Casos de uso
Cena de bar, de balada e de bastidor
O tipo de plano que precisa do próprio barulho: gelo na coqueteleira, uma frase sussurrada, um sax duas salas adiante. Escreva a sala dentro do prompt e deixe generate_audio ligado — o Seedance 2.5 renderiza a ambiência contra a imagem em vez de te entregar um plano mudo.
Curtas sem censura, casais incluídos
Cenas que o aplicativo oficial bloqueia, com casais de qualquer gênero, funcionam aqui, e não revisamos o que você gera. A camada de segurança própria do Seedance ainda recusa algumas formulações de beijo, então o caminho confiável é um quadro inicial na imagem para vídeo.
Filme de produto que começa no packshot
Mande a fotografia aprovada para o image-to-video: geometria, rótulo e tratamento de cor ficam exatamente como foram fotografados enquanto só a câmera se move. Nada precisa ser reiluminado nem reaprovado, e last_image_url faz o movimento aterrissar de volta no quadro-herói para fechar um loop limpo.
Personagem de série que continua sendo a mesma pessoa
Monte um conjunto pequeno de referências — três ângulos do rosto, uma foto de figurino, um clipe da caminhada — e reaproveite entre episódios no reference-to-video. Trinta imagens cabem numa requisição, então o elenco viaja junto com o prompt, não com um seed.
Guia de prompt e dicas práticas
Escolha o endpoint pelo que você já tem em mãos
Uma descrição e nada mais vai para o text-to-video. Uma imagem que precisa ser mantida vai para o image-to-video. Um elenco, um produto ou um movimento que precisa sobreviver a vários planos vai para o reference-to-video. Chamando pelo nome da família, são os campos que você manda que escolhem o endpoint.
Escreva o plano, não a fotografia
Sujeito, ação, câmera, luz, som — nessa ordem, uma ideia por frase. O clipe desta página saiu exatamente deste texto: “Warm, clearly lit close two-shot. Two adult women stand very close in the amber glow of a jazz bar's back hallway, one in a black velvet slip, the other in an open white shirt. One leans in and whispers something against the other's ear; the other closes her eyes and breaks into a wide laugh, then they rest their foreheads together. Handheld 35mm, warm practical lights, shallow focus, muffled saxophone, a whispered line and soft laughter.” Cinco segundos, 720p, 16:9, áudio ligado.
Crie como tarefa assíncrona e consulte o estado
Mande um Idempotency-Key, guarde o id da tarefa que volta e depois faça polling ou espere o callback. Depois de uma conexão caída, consulte a tarefa em vez de criar de novo. Confira a estimativa antes:
duration_secondse resolution mexem nela, e no reference-to-video o material de referência também.
Introdução
Seedance 2.5 Extensão de vídeo continua um clipe que você já tem. Envie-o como video_url com um prompt sobre o que acontece depois. A plataforma pega no máximo os últimos 30 segundos do clipe (o clipe inteiro, se for mais curto) e passa para o Seedance 2.5 reference-to-video como vídeo de referência. O modelo gera um novo trecho de 4 a 30 segundos que leva a cena adiante, e os dois são unidos em um único MP4: primeiro o seu original completo, depois a continuação. O novo trecho também volta como arquivo próprio, para você continuar estendendo ou editar as partes separadamente.
Principais recursos e destaques
A continuidade vem de um trecho de vídeo, não de um único quadro. O Seedance lê o final do clipe, com movimento, direção da câmera e som, como contexto, então velocidade e direção seguem melhor do que quando um modelo vê só uma imagem parada. O primeiro quadro novo é gerado, não copiado do último, então descreva o movimento que você quer continuar e mantenha a mesma linguagem de câmera.
Você paga pelo que o modelo lê e pelo que ele cria. O preço é a tarifa por segundo do Seedance 2.5 reference-to-video com vídeo de referência, aplicada aos segundos de referência mais os segundos novos. A referência tem teto de 30 segundos, então uma origem de 60 segundos cobra 30 segundos de referência; tudo o que vem antes só é lido e unido de novo. Os segundos de referência são arredondados para segundos inteiros e vale o mínimo do próprio Seedance: um trecho de 5 segundos cobra pelo menos 4 segundos de referência.
Um arquivo de volta, mais a parte nova sozinha. O arquivo unido mantém a taxa de quadros e o enquadramento do seu clipe, sem barras pretas, e é codificado como MP4 H.264 com som AAC. Para alinhar a emenda, a imagem pode ser cortada ou ajustada em alguns pontos percentuais nas bordas. Se o modelo devolver uma proporção bem diferente, o novo trecho é redimensionado para preencher o seu quadro, centralizado, e o que sobra é cortado. O som do seu clipe fica, o som gerado para o novo trecho vem em seguida com um fade curto na emenda, e um lado sem som é completado com silêncio. O segundo recurso da saída é só o novo trecho.
Todo o resto é o Seedance 2.5 reference-to-video. O novo trecho passa pelas mesmas rotas, com a mesma faixa de conteúdo desse endpoint, e uma geração que falha é reembolsada do mesmo jeito. Se a geração der certo, mas a união não puder ser montada, a tarefa falha e a cobrança é reembolsada. Uma origem com menos de 2 segundos é curta demais para continuar e é recusada.
Casos de uso
Alongue uma tomada que terminou cedo demais: uma dança que para no meio do passo, um travelling que corta antes de a pessoa chegar à porta, um produto que para de girar antes de o rótulo virar para a câmera. Estenda e descreva a ação que falta.
Monte uma sequência mais longa passo a passo. Gere uma primeira tomada, estenda, depois estenda de novo o resultado unido. Cada passo cobra a referência lida (no máximo 30 segundos) mais os segundos adicionados. As origens têm limite de 60 segundos, então numa cadeia longa estenda o trecho mais recente em vez do clipe unido inteiro.
Guia de prompts e dicas
Descreva o próximo momento, não a cena inteira. A referência já mostra quem e onde, então use o prompt para a ação seguinte, o movimento de câmera e o som. Repita a linguagem de câmera com que o clipe termina, como uma aproximação lenta ou uma câmera na mão, para a emenda parecer uma única tomada.
Termine a origem onde você quer continuar. O Seedance se apoia nos últimos segundos da referência; um clipe que termina no meio de um corte, num fade ou em outra tomada puxa a continuação para o lado errado. Corte antes. Aceitamos origens de 2 a 60 segundos em MP4, MOV ou WebM.
Mantenha a mesma resolução. A resolução define só a qualidade do novo trecho, então um trecho em 480p depois de um clipe em 1080p fica mais suave que o original. Escolha a resolução do seu clipe e ajuste duration_seconds para a duração de que você realmente precisa: ela soma aos segundos de referência na cobrança.
Use apenas adultos que deram consentimento e material licenciado. Todas as pessoas presentes em imagens, clipes ou áudios de referência precisam ter autorizado o uso. Não são permitidos menores, imagens íntimas sem consentimento ou personificação enganosa de pessoas reais.
Quem usa a API deve obter autorizações de direitos autorais e de imagem para cada referência, clipe e arquivo de áudio, além dos direitos de marca, música e uso comercial.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5/video-extend",
"input": {
"duration_seconds": 5,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
