switch_heading

Documentação Seedance 1.5 API

Guia completo para integrar a API de geração de vídeo Seedance 1.5 em suas aplicações.

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

Início Rápido

bash

1	curl -X POST 'https://seedanceapi.org/v1/generate' \
2	-H 'Authorization: Bearer YOUR_API_KEY' \
3	-H 'Content-Type: application/json' \
4	-d '{
5	"prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "8"
9	}'

Autenticação

Todas as requisições da API requerem autenticação usando um token Bearer no cabeçalho Authorization.

Importante: Você pode obter sua chave API na página API Keys no seu painel. → Obter chave API

http

1	Authorization: Bearer YOUR_API_KEY

Preços

480p

480p Resolução

Geração rápida, adequada para pré-visualizações e rascunhos

Duração	Sem áudio	Com áudio
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

720p Resolução

Saída de alta qualidade, recomendada para produção

Duração	Sem áudio	Com áudio
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

Endpoints da API

POST/v1/generateGerar novo vídeo

Criar nova tarefa de geração de vídeo com o modelo Seedance 1.5. Suporta texto-para-vídeo e imagem-para-vídeo.

Corpo da Requisição

Body ParametersJSON

prompt:string

Descrição textual do vídeo a gerar (máx. 2000 caracteres)

aspect_ratio:optional string

Proporção da tela de saída. Suportadas: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

Resolução do vídeo: 480p ou 720p Defaults to 720p.

duration:optional string

Duração do vídeo em segundos: 4, 8 ou 12 Defaults to 8.

generate_audio:optional boolean

Ativar geração de áudio IA para o vídeo Defaults to false.

fixed_lens:optional boolean

Fixar a câmera para reduzir desfoque de movimento Defaults to false.

image_urls:optional string[]

Array de URLs de imagens de referência para imagem-para-vídeo (máx. 1)

callback_url:optional string

URL webhook para notificações de status assíncronas. Deve ser acessível publicamente.

Texto para vídeo

json

1	{
2	"prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8"
6	}

Imagem para vídeo

json

1	{
2	"prompt": "The character slowly turns and smiles at the camera",
3	"image_urls": [
4	"https://example.com/my-image.jpg"
5	],
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "4"
9	}

Com geração de áudio

json

1	{
2	"prompt": "A peaceful river flowing through a forest with birds singing",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8",
6	"generate_audio": true,
7	"fixed_lens": true
8	}

Respostas

Task created successfully

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "IN_PROGRESS"
7	}
8	}

GET/v1/statusObter status da tarefa

Verificar o status de uma tarefa de geração de vídeo e obter o resultado quando concluída.

Parâmetros de Consulta

Body ParametersJSON

task_id:string

O ID único da tarefa retornado do endpoint generate

Exemplo de Requisição

bash

1	curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
2	-H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: O campo response na API de status é um array de URLs de vídeo. Acesse diretamente data.response[0] para obter a URL do vídeo.

javascript

1	// Extract video URL from response
2	const videoUrl = data.response[0];

Respostas

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "SUCCESS",
7	"consumed_credits": 28,
8	"created_at": "2026-02-07T10:30:00Z",
9	"request": {
10	"prompt": "A majestic eagle soaring through golden sunset clouds",
11	"aspect_ratio": "16:9",
12	"resolution": "720p",
13	"duration": "8"
14	},
15	"response": [
16	"https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17	],
18	"error_message": null
19	}
20	}

Playground da API

Teste a API diretamente do seu navegador. Substitua YOUR_API_KEY pela sua chave API real.

Playground da APIPOST

URL Base

Endpoint

Cabeçalhos

Corpo da Requisição

Códigos de Erro

Status	Code	Description
400 Requisição Inválida	`INVALID_PROMPT`	O prompt é inválido ou vazio
400 Requisição Inválida	`INVALID_ASPECT_RATIO`	Proporção de tela não suportada
400 Requisição Inválida	`INVALID_RESOLUTION`	Resolução deve ser 480p ou 720p
400 Requisição Inválida	`INVALID_DURATION`	Duração deve ser 4, 8 ou 12 segundos
400 Requisição Inválida	`TOO_MANY_IMAGES`	Máximo 1 URL de imagem permitida no array image_urls
401 Não autorizado	`INVALID_API_KEY`	Chave API ausente ou inválida
402	`INSUFFICIENT_CREDITS`	Créditos insuficientes para esta operação
404 Não encontrado	`TASK_NOT_FOUND`	ID da tarefa não encontrado ou não pertence à sua conta
500 Erro Interno do Servidor	`INTERNAL_ERROR`	Erro do servidor, por favor tente novamente mais tarde

switch_heading