label llms.txt open_chatgpt

Documentação Seedance 2.0 Mini API

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

API v1 · 2.0 Mini Base URL: https://seedanceapi.org/v1

Início Rápido

bash
1curl -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
1Authorization: Bearer YOUR_API_KEY

Preços

480p

480p Resolução

14,25 créditos por segundo de saída, arredondado para cima

DuraçãoCréditos
4s57 credits
5s72 credits
8s114 credits
10s143 credits
12s171 credits
15s214 credits
720p

720p Resolução

30,75 créditos por segundo de saída, arredondado para cima

DuraçãoCréditos
4s123 credits
5s154 credits
8s246 credits
10s308 credits
12s369 credits
15s462 credits

Endpoints da API

POST/v1/generate

Criar nova tarefa de geração de vídeo com o modelo Seedance 2.0 Mini. 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 de saída. Suportadas: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive 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: inteiro 4–15 Defaults to 8.

generate_audio:optional boolean

Ativar geração de áudio por IA (não afeta o preço) Defaults to false.

fixed_lens:optional boolean

Obsoleto — aceito por compatibilidade, ignorado pelo Seedance 2.0 Mini 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}

Respostas

Task created successfully

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

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
1curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \
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
2const videoUrl = data.response[0];

Respostas

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90abc123def456_seedance",
6 "status": "SUCCESS",
7 "consumed_credits": 246,
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/n90abc123def456_seedance.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

Códigos de Erro

StatusCodeDescription
400 Requisição InválidaINVALID_PROMPTO prompt é inválido ou vazio
400 Requisição InválidaINVALID_ASPECT_RATIOProporção de tela não suportada
400 Requisição InválidaINVALID_RESOLUTIONResolução deve ser 480p ou 720p
400 Requisição InválidaINVALID_DURATIONDuração deve ser 4, 8 ou 12 segundos
400 Requisição InválidaTOO_MANY_IMAGESMáximo 1 URL de imagem permitida no array image_urls
401 Não autorizadoINVALID_API_KEYChave API ausente ou inválida
402 INSUFFICIENT_CREDITSCréditos insuficientes para esta operação
404 Não encontradoTASK_NOT_FOUNDID da tarefa não encontrado ou não pertence à sua conta
500 Erro Interno do ServidorINTERNAL_ERRORErro do servidor, por favor tente novamente mais tarde