switch_heading
Documentação da API Seedance 2.5
Gere vídeos Seedance 2.5 e Seedance 2.5 Flash pela API v3: texto para vídeo, imagens, vídeos e áudios de referência, primeiro/último quadro, edição de vídeo e saída 4K.
A API v3 é um endpoint separado somente para o Seedance 2.5. As integrações existentes em /v1 e /v2 continuam funcionando exatamente como antes; mude para /v3 apenas quando quiser o Seedance 2.5.
Início rápido
| 1 | curl -X POST 'https://seedanceapi.org/v3/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedance-2.5", |
| 6 | "prompt": "A cinematic aerial shot over a coastline at golden hour", |
| 7 | "aspect_ratio": "16:9", |
| 8 | "resolution": "720p", |
| 9 | "duration": 10 |
| 10 | }' |
Autenticação
Todas as requisições à API exigem um token Bearer no cabeçalho Authorization.
Importante: Obtenha sua chave de API na página API Keys do seu painel. Mantenha-a no seu servidor e nunca a inclua em código de navegador. → Obter sua chave de API
| 1 | Authorization: Bearer YOUR_API_KEY |
Modos de geração
| Modo | Campos a enviar |
|---|---|
| Texto para vídeo | prompt + aspect_ratio |
| Geração por referência (imagens, vídeo, áudio) | prompt + image_urls / reference_video_urls / reference_audio_urls |
| Primeiro / último quadro | prompt + first_frame_url (+ last_frame_url) |
| Edição de vídeo | prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive" |
Preços (créditos)
Os créditos são cobrados por segundo de vídeo e dependem do modelo, da resolução e do envio ou não de vídeos de referência. O valor é debitado na criação da tarefa e reembolsado automaticamente em caso de falha.
Precisa recarregar créditos? → Recarregue na página de preços. 1 USD = 100 créditos.
Seedance 2.5
Qualidade máxima, com suporte a 480p, 720p e 4K nativo.
| Resolução | Entrada | Taxa | Exemplo |
|---|---|---|---|
| 480p | Texto / imagens / áudio | 28 créditos / s | 10 s de saída = 280 créditos |
| 480p | Com vídeo de referência | 17 créditos / s | 5 s de referência + 10 s de saída = 255 créditos |
| 720p | Texto / imagens / áudio | 63 créditos / s | 10 s de saída = 630 créditos |
| 720p | Com vídeo de referência | 38 créditos / s | 5 s de referência + 10 s de saída = 570 créditos |
| 4k | Texto / imagens / áudio | 251 créditos / s | 10 s de saída = 2510 créditos |
| 4k | Com vídeo de referência | 155 créditos / s | 5 s de referência + 10 s de saída = 2325 créditos |
Seedance 2.5 Flash
Mais rápido e mais barato, com suporte a 480p e 720p.
| Resolução | Entrada | Taxa | Exemplo |
|---|---|---|---|
| 480p | Texto / imagens / áudio | 18.5 créditos / s | 10 s de saída = 185 créditos |
| 480p | Com vídeo de referência | 11.5 créditos / s | 5 s de referência + 10 s de saída = 173 créditos |
| 720p | Texto / imagens / áudio | 41 créditos / s | 10 s de saída = 410 créditos |
| 720p | Com vídeo de referência | 25.5 créditos / s | 5 s de referência + 10 s de saída = 383 créditos |
Com reference_video_urls, a cobrança usa a taxa mais baixa de entrada de vídeo sobre os segundos de vídeo de referência, somada aos segundos de saída. A edição de vídeo (duration -1) cobra o dobro da duração do vídeo de entrada. Os totais são arredondados para cima até um crédito inteiro.
Endpoints da API
/v3/generateInicie um job Seedance 2.5 ou Seedance 2.5 Flash. A chamada retorna um task_id imediatamente; consulte /v3/status ou passe callback_url para obter o resultado.
Corpo da requisição
Prompt de texto (obrigatório, até 5000 caracteres).
seedance-2.5 (padrão) ou seedance-2.5-flash. Defaults to seedance-2.5.
Duração de saída em segundos: qualquer inteiro de 4 a 30. Use -1 para edição de vídeo, em que a saída mantém a duração do vídeo de entrada. Defaults to 5.
Seedance 2.5: 480p, 720p ou 4k. Seedance 2.5 Flash: 480p ou 720p. 1080p não está disponível. Defaults to 720p.
16:9, 9:16, 4:3, 3:4 ou adaptive. A edição de vídeo exige adaptive. Defaults to 16:9.
Até 4 URLs de imagens de referência (http/https). Descreva no prompt como cada imagem deve ser usada.
URL de imagem usada como primeiro quadro. Não pode ser combinada com image_urls, reference_video_urls ou reference_audio_urls.
URL de imagem opcional usada como último quadro. Requer first_frame_url.
Até 3 URLs de vídeos de referência, 30 segundos no total. Para edição de vídeo, envie exatamente um vídeo entre 4 e 30 segundos.
Até 3 URLs de áudio de referência, por exemplo música ou uma faixa de voz.
Gera uma trilha sonora junto com o vídeo. Defaults to true.
Permite que o modelo pesquise na web os assuntos do prompt. Defaults to false.
Webhook opcional chamado quando a tarefa termina (URL pública; localhost não é permitido).
Opcional: permite que o resultado apareça na galeria pública.
Texto para vídeo
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "A slow dolly shot through a neon-lit street in the rain", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "720p", |
| 6 | "duration": 10 |
| 7 | } |
Imagem de referência + áudio
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio", |
| 4 | "image_urls": ["https://example.com/character.jpg"], |
| 5 | "reference_audio_urls": ["https://example.com/beat.mp3"], |
| 6 | "aspect_ratio": "9:16", |
| 7 | "resolution": "720p", |
| 8 | "duration": 8 |
| 9 | } |
Primeiro e último quadro (Flash)
| 1 | { |
| 2 | "model": "seedance-2.5-flash", |
| 3 | "prompt": "The flower bud slowly opens into full bloom", |
| 4 | "first_frame_url": "https://example.com/bud.jpg", |
| 5 | "last_frame_url": "https://example.com/bloom.jpg", |
| 6 | "resolution": "480p", |
| 7 | "duration": 6 |
| 8 | } |
Edição de vídeo
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Change the season to winter with falling snow; keep the camera motion", |
| 4 | "reference_video_urls": ["https://example.com/input-12s.mp4"], |
| 5 | "aspect_ratio": "adaptive", |
| 6 | "duration": -1, |
| 7 | "resolution": "720p" |
| 8 | } |
Saída 4K
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Macro shot of morning dew rolling off a green leaf", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "4k", |
| 6 | "duration": 5 |
| 7 | } |
Respostas
Task created
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "IN_PROGRESS", |
| 7 | "consumed_credits": 630 |
| 8 | } |
| 9 | } |
/v3/statusConsulte pelo task_id até que status seja SUCCESS ou FAILED. Apenas tarefas criadas com /v3/generate são retornadas aqui.
Parâmetros de consulta
ID da tarefa retornado por POST /v3/generate (termina com sd25).
Exemplo de requisição
| 1 | curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
Tip: Quando status é SUCCESS, data.response é um array de URLs de vídeo; use data.response[0] para a primeira URL. Baixe e guarde o arquivo se precisar mantê-lo.
| 1 | const videoUrl = data.response[0]; |
Respostas
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 630, |
| 8 | "created_at": "2026-11-19T10:30:00Z", |
| 9 | "type": "seedance-2.5-t2v", |
| 10 | "request": { |
| 11 | "model": "seedance-2.5", |
| 12 | "prompt": "A slow dolly shot…", |
| 13 | "aspect_ratio": "16:9", |
| 14 | "duration": 10 |
| 15 | }, |
| 16 | "response": [ |
| 17 | "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4" |
| 18 | ], |
| 19 | "error_message": null |
| 20 | } |
| 21 | } |
Playground da API
Teste a API no navegador. Substitua YOUR_API_KEY pela sua chave real. Cada chamada bem-sucedida é cobrada.
Códigos de erro
| Status | Quando acontece |
|---|---|
| 400 Requisição Inválida | Um parâmetro está faltando ou é inválido, por exemplo um model, resolution, aspect_ratio, duration ou URL de mídia não suportado. A mensagem explica qual. |
| 401 Não autorizado | Chave de API ausente ou inválida. |
| 402 | Créditos insuficientes para esta tarefa. |
| 404 Não encontrado | A tarefa não existe ou não foi criada com /v3/generate. |
| 500 Erro Interno do Servidor | Erro no servidor. Tente novamente mais tarde; tarefas com falha são reembolsadas automaticamente. |