Feito para preview rapido
Use requisicoes estilo Seedance 2.5 API para testar prompts, comparar ideias de movimento e criar clipes compactos antes de renders maiores.
Guia Seedance 2.5 API
Seedance 2.5 API para geracao rapida de video IA
Esta pagina Seedance 2.5 API explica como criar um fluxo leve de geracao sobre Seedance API v2. Use o modelo seedance-2.0 para clipes compactos, previews, social video e workflows de produto em alto volume sem infraestrutura GPU propria.
- Duracao
- 5-15s
- Caminho modelo
- v2
- Entradas
- T2V + I2V
- Interface
- REST
Jobs de 4-15 segundos
Use seedance-2.0
Prompt ou imagens
JSON via HTTPS
Requisicao 2.5 planning
Comece pelo modelo nativo Seedance 2.0 Mini
curl -X POST 'https://seedanceapi.org/v2/generate' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2.0",
"prompt": "A cinematic product reveal with smooth dolly-in camera motion",
"duration": 10,
"aspect_ratio": "16:9"
}'Seedance API v2 expoe seedance-2.0 para jobs Mini. Use duracoes de 4-15 segundos, saida 480p ou 720p e prompts focados para geracao leve.
Por que usar um fluxo Seedance 2.5 API?
O fluxo Seedance 2.5 API e util quando equipes precisam de velocidade, custos previsiveis e integracao REST simples mais do que renderizacao cinematica longa.
Acesso simples por API key
Desenvolvedores autenticam com Bearer tokens, criam jobs com POST /v2/generate e consultam GET /v2/status no mesmo padrao da API Seedance 2.0 completa.
Limites bons para producao
Duracao curta, aspect ratios claros e polling async tornam o fluxo Seedance 2.5 API mais facil de encaixar em filas e moderacao.
Capacidades Seedance 2.5 API
O fluxo 2.5 API foca nos recursos da Seedance 2.0 API importantes para apps de video leves e geracao automatica de previews.
Modelo Mini nativo
Defina model como seedance-2.0 quando quiser comportamento Seedance 2.5 API para iteracao rapida e jobs menores.
Clipes text-to-video
Envie prompt conciso, aspect ratio, resolution e duration para gerar assets curtos para apps, social media e testes criativos.
Movimento image-to-video
Forneca uma a quatro image URLs, ou reference video URLs compativeis com Mini, mantendo um payload Seedance 2.5 API compacto.
Duracoes curtas
Use qualquer duracao inteira de 4 a 15 segundos; 8 segundos e um bom inicio para previews 2.5 API.
Polling async de status
Cada request retorna task id, para o app consultar status, atualizar UI e buscar a URL final quando pronta.
Base v2 compartilhada
O fluxo Seedance 2.5 API usa a mesma autenticacao, cobranca e formato de resposta v2 da Seedance 2.0 API ampla.
Como usar Seedance 2.5 API
Comece pelos endpoints Seedance API v2 existentes e ajuste o request para output compacto.
Crie uma chave API
Entre, abra API Keys e copie uma chave para uso no servidor. Mantenha a chave fora do browser code e repos publicos.
Enviar um job Mini
Chame POST /v2/generate com model seedance-2.0, prompt focado, duration 8, resolution 720p e aspect ratio necessario.
Consulte e renderize
Use GET /v2/status com task_id. Quando status for SUCCESS, leia data.response[0] e mostre ou armazene a URL do video.
Padrao de request Seedance 2.5 API
O fluxo 2.5 API e pequeno por design: autenticar, criar a tarefa e consultar ate concluir.
POST /v2/generate
Cria uma tarefa Seedance 2.0 Mini. Use text prompts para text-to-video, images para image-to-video ou reference_video_urls para video input.
GET /v2/status
Retorna estado de processamento, detalhes de falha ou response final com a URL do video gerado.
Callback URL opcional
Para sistemas async, inclua callback_url publico quando a integracao suportar. Nao use localhost URLs.
Parametros recomendados 2.5 API
| Parametro | Valor recomendado |
|---|---|
| model | Use seedance-2.0 no fluxo 2.5 API. |
| prompt | Mantenha focado e especifico; maximo 2000 caracteres. |
| duration | Use qualquer inteiro de 4 a 15 segundos. |
| resolution | Use 480p ou 720p para output Mini. |
| aspect_ratio | Use 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 ou adaptive para text-to-video. |
| images | Use uma a quatro image URLs HTTPS para image-to-video. |
| reference_video_urls | Reference video URLs opcionais compativeis com Mini para geracao guiada por video. |
| reference_audio_urls | Reference audio URLs opcionais para geracao compativel com Mini. |
| callback_url | Webhook URL publico opcional para notificacoes async. |
Para referencia completa, use a documentacao Seedance 2.0 API v2. Esta pagina restringe a mesma API a uma implementacao 2.5 planning.
Melhores casos de uso Seedance 2.5 API
2.5 API workflows sao ideais quando usuarios precisam de quick motion previews ou video gerado leve dentro de um produto existente.
Social video previews
Gere clipes verticais compactos para feed previews, ideias de ads e ferramentas de criadores.
Testes de movimento de produto
Anime product shots ou visuais de campanha com requests image-to-video curtos antes da aprovacao final.
Ferramentas de prompt iteration
Permita testar muitas variantes de prompt, comparar resultados e promover o melhor prompt para render maior.
Automacao de alto volume
Use short fast jobs para batch previews, content pipelines e apps que precisam de throughput previsivel.
Notas de integracao em producao
Um fluxo Seedance 2.5 API ainda precisa do mesmo cuidado operacional de qualquer integracao video API em producao.
Execute chamadas pelo backend
Guarde API keys no servidor, chame Seedance API no backend e exponha aos clientes apenas seus endpoints seguros.
Use fila e retry
Use uma queue para concorrencia, retry de falhas transitorias e UI responsiva durante o processamento.
Acompanhe credits e status
Monitore credit usage, task status e error responses para manter o fluxo 2.5 API previsivel conforme escala.
Seedance 2.5 API vs uso v2 standard
2.5 API e uma escolha de workflow sobre Seedance API v2. Use para clipes rapidos e mude para standard quando qualidade ou duracao importarem mais.
2.5 API prioriza velocidade
Use fast routing, durations curtas e prompts focados quando precisar de feedback rapido.
Standard v2 prioriza qualidade
Use o caminho standard Seedance 2.0 quando cinematic quality e cenas ricas forem prioridade.
Ambos compartilham a mesma API base
Authentication, billing, status polling e response parsing ficam consistentes entre 2.5 planning e uso v2 standard.
| Capacidade | 2.5 planning | Uso v2 standard |
|---|---|---|
| Model hint | seedance-2.0 | seedance-2.0 |
| Melhor duracao | 4-15 segundos | 5, 10 ou 15 segundos |
| Melhor uso | Previews, batches, iteracao rapida | Creative final, storytelling mais rico |
| Formato API | Mesmos /v2/generate e /v2/status | Mesmos /v2/generate e /v2/status |
FAQ Seedance 2.5 API
Respostas para developers avaliando uma integracao estilo Seedance 2.5 API.
Existe endpoint separado Seedance 2.5 API?
Sim. Use Seedance API v2 com model seedance-2.0. A rota publica atual e POST /v2/generate e depois GET /v2/status.
Para que Seedance 2.5 API e melhor?
Short previews, social video tests, product motion drafts e high-volume prompt iteration.
Posso usar image-to-video?
Sim. Envie uma a quatro image URLs no campo images e mantenha o prompt focado no movimento desejado.
Qual duracao devo iniciar?
Mini aceita qualquer duracao inteira de 4 a 15 segundos. Comece com 8 segundos para previews rapidos e aumente a duracao para uma cena mais completa.
Quais aspect ratios sao suportados?
Para text-to-video, Mini aceita 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 e adaptive. Escolha o ratio adequado ao seu placement.
Como autenticar requests?
Passe Authorization: Bearer YOUR_API_KEY em todo request. Mantenha essa key no backend.
Como obter a URL final do video?
Consulte GET /v2/status com task_id. Quando status for SUCCESS, leia a primeira URL em data.response[0].
Funciona com qualquer linguagem?
Sim. O workflow usa HTTPS e JSON padrao, entao funciona com cURL, Python, Node.js, Go, Java e outros HTTP clients.
Devo chamar a API direto do browser?
Nao. Use backend ou BFF para proteger API keys, validar prompts, aplicar rate limits e tratar retries.
Como funciona billing?
Seedance API usa credits. O custo depende do model e da duration; short fast jobs sao mais faceis de prever.
Posso migrar de 2.5 planning para standard Seedance 2.0?
Sim. Mantenha o endpoint e mude model hint, duration e prompt strategy quando precisar de renders de maior qualidade.
Onde encontro a documentacao completa?
Abra a documentacao Seedance 2.0 API v2 para request schema, response examples, pricing tables e error codes.
Crie seu primeiro job Seedance 2.5 API
Crie uma API key, envie um request Mini curto e conecte geracao de video IA leve ao seu produto.