label llms.txt open_chatgpt

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.

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

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

bash
1curl -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

http
1Authorization: Bearer YOUR_API_KEY

Modos de geração

ModoCampos a enviar
Texto para vídeoprompt + aspect_ratio
Geração por referência (imagens, vídeo, áudio)prompt + image_urls / reference_video_urls / reference_audio_urls
Primeiro / último quadroprompt + first_frame_url (+ last_frame_url)
Edição de vídeoprompt + 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.

2.5

Seedance 2.5

Qualidade máxima, com suporte a 480p, 720p e 4K nativo.

ResoluçãoEntradaTaxaExemplo
480pTexto / imagens / áudio28 créditos / s10 s de saída = 280 créditos
480pCom vídeo de referência17 créditos / s5 s de referência + 10 s de saída = 255 créditos
720pTexto / imagens / áudio63 créditos / s10 s de saída = 630 créditos
720pCom vídeo de referência38 créditos / s5 s de referência + 10 s de saída = 570 créditos
4kTexto / imagens / áudio251 créditos / s10 s de saída = 2510 créditos
4kCom vídeo de referência155 créditos / s5 s de referência + 10 s de saída = 2325 créditos
Flash

Seedance 2.5 Flash

Mais rápido e mais barato, com suporte a 480p e 720p.

ResoluçãoEntradaTaxaExemplo
480pTexto / imagens / áudio18.5 créditos / s10 s de saída = 185 créditos
480pCom vídeo de referência11.5 créditos / s5 s de referência + 10 s de saída = 173 créditos
720pTexto / imagens / áudio41 créditos / s10 s de saída = 410 créditos
720pCom vídeo de referência25.5 créditos / s5 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

POST/v3/generate

Inicie 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

Body ParametersJSON
prompt:string

Prompt de texto (obrigatório, até 5000 caracteres).

model:optional string

seedance-2.5 (padrão) ou seedance-2.5-flash. Defaults to seedance-2.5.

duration:optional number

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.

resolution:optional string

Seedance 2.5: 480p, 720p ou 4k. Seedance 2.5 Flash: 480p ou 720p. 1080p não está disponível. Defaults to 720p.

aspect_ratio:optional string

16:9, 9:16, 4:3, 3:4 ou adaptive. A edição de vídeo exige adaptive. Defaults to 16:9.

image_urls:optional string[]

Até 4 URLs de imagens de referência (http/https). Descreva no prompt como cada imagem deve ser usada.

first_frame_url:optional string

URL de imagem usada como primeiro quadro. Não pode ser combinada com image_urls, reference_video_urls ou reference_audio_urls.

last_frame_url:optional string

URL de imagem opcional usada como último quadro. Requer first_frame_url.

reference_video_urls:optional string[]

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.

reference_audio_urls:optional string[]

Até 3 URLs de áudio de referência, por exemplo música ou uma faixa de voz.

generate_audio:optional boolean

Gera uma trilha sonora junto com o vídeo. Defaults to true.

web_search:optional boolean

Permite que o modelo pesquise na web os assuntos do prompt. Defaults to false.

callback_url:optional string

Webhook opcional chamado quando a tarefa termina (URL pública; localhost não é permitido).

public:optional boolean

Opcional: permite que o resultado apareça na galeria pública.

Texto para vídeo

json
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

json
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)

json
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

json
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

json
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}
GET/v3/status

Consulte pelo task_id até que status seja SUCCESS ou FAILED. Apenas tarefas criadas com /v3/generate são retornadas aqui.

Parâmetros de consulta

Body ParametersJSON
task_id:string

ID da tarefa retornado por POST /v3/generate (termina com sd25).

Exemplo de requisição

bash
1curl -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.

javascript
1const 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.

Playground da APIPOST

Códigos de erro

StatusQuando acontece
400 Requisição InválidaUm 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 autorizadoChave de API ausente ou inválida.
402 Créditos insuficientes para esta tarefa.
404 Não encontradoA tarefa não existe ou não foi criada com /v3/generate.
500 Erro Interno do ServidorErro no servidor. Tente novamente mais tarde; tarefas com falha são reembolsadas automaticamente.