Criar um vídeo Seedance

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

Escolha um valor documentado WxH na tabela abaixo para o campo size.

Use doubao-seedance-2-0-mini exatamente para Seedance 2.0 Mini. O valor abreviado seedance-mini não é um ID de modelo válido.

IDs de modelos compatíveis

Use um destes valores exatos para o campo model.

Modelo	ID exato do modelo	Modos e níveis de resolução	Compatível `seconds`
Seedance 2.0	`doubao-seedance-2-0`	Texto para vídeo, imagem para vídeo; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Texto para vídeo, imagem para vídeo; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Texto para vídeo, imagem para vídeo; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Texto para vídeo; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Texto para vídeo; `480p`, `720p`, `1080p`	`2`-`10`

Usar imagens de referência

Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini aceitam input_reference. Para prompts avançados com múltiplas referências em uma rota que os suporta, repita o mesmo campo multipart na ordem de upload. Uma solicitação de produção Mini com um único input_reference foi concluída em 720x1280. Essa verificação confirmou a conclusão da solicitação, mas não isolou o efeito visual da imagem de referência em relação ao prompt. Seedance 2.0 é sensível à forma como o prompt conecta cada imagem de referência à cena. Faça referência aos arquivos enviados pela ordem, como [Image 1], [Image 2] e [Image 3], e atribua a cada imagem uma função clara:

Use [Image 1] para o sujeito, personagem ou produto principal.
Use [Image 2] para um sujeito secundário, adereço ou acompanhante.
Use [Image 3] para o plano de fundo, cenário, iluminação ou estilo.

Descreva o que deve permanecer reconhecível, o que pode mudar, a ação, o movimento da câmera, o estilo visual e a cena. Um prompt vago pode fazer o vídeo gerado parecer que a imagem de referência não foi usada, mesmo quando o upload foi aceito. Esta estrutura de prompt é mais confiável do que apenas listar imagens:

Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters.

Duração por modelo

Se você omitir seconds, a CometAPI solicitará um clipe de 5 segundos. Envie seconds como uma cadeia de caracteres quando precisar de uma duração específica.

Família de modelos	Compatível `seconds`	Padrão	Comportamento nos limites
Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini	`4`-`15`	`5`	Use segundos inteiros dentro do intervalo.
Seedance 1.5 Pro	`4`-`12`	`5`	Use segundos inteiros dentro do intervalo.
Seedance 1.0 Pro	`2`-`10`	`5`	Use segundos inteiros dentro do intervalo.

Suporte de tamanho por modelo

A tabela abaixo reúne os valores exatos de WxH em um só lugar. Seedance 2.0 Fast usa apenas os valores 480p e 720p na quinta coluna. Os valores de 1080p nessa coluna aplicam-se ao Seedance 1.5 Pro e ao Seedance 2.0 padrão. Os valores de 4K aplicam-se apenas ao Seedance 2.0 padrão. Na coluna Mini, — significa que a resolução não é compatível.

Classe de resolução	Proporção	Seedance 2.0 Mini	Série Seedance 1.0	Seedance 1.5 Pro / Seedance 2.0 padrão / Fast
`480p`	`16:9`	`864x496`	`864x480`	`864x496`
	`4:3`	`752x560`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`	`640x640`
	`3:4`	`560x752`	`544x736`	`560x752`
	`9:16`	`496x864`	`480x864`	`496x864`
	`21:9`	`992x432`	`960x416`	`992x432`
`720p`	`16:9`	`1280x720`	`1248x704`	`1280x720`
	`4:3`	`1112x834`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`	`960x960`
	`3:4`	`834x1112`	`832x1120`	`834x1112`
	`9:16`	`720x1280`	`704x1248`	`720x1280`
	`21:9`	`1470x630`	`1504x640`	`1470x630`
`1080p`	`16:9`	—	`1920x1088`	`1920x1080`
	`4:3`	—	`1664x1248`	`1664x1248`
	`1:1`	—	`1440x1440`	`1440x1440`
	`3:4`	—	`1248x1664`	`1248x1664`
	`9:16`	—	`1088x1920`	`1080x1920`
	`21:9`	—	`2176x928`	`2206x946`
`4K`	`16:9`	—	—	`3840x2160` (Somente Seedance 2.0)
	`4:3`	—	—	`3326x2494` (Somente Seedance 2.0)
	`1:1`	—	—	`2880x2880` (Somente Seedance 2.0)
	`3:4`	—	—	`2494x3326` (Somente Seedance 2.0)
	`9:16`	—	—	`2160x3840` (Somente Seedance 2.0)
	`21:9`	—	—	`4398x1886` (Somente Seedance 2.0)

O Seedance 2.0 Mini é compatível com 480p e 720p, mas não com 1080p nem 4K. Em uma verificação de produção, uma solicitação Mini para 1920x1080 produziu 1280x720.

Escolha o valor documentado de WxH para o modelo de destino. A compatibilidade exata com WxH continua dependente do modelo, portanto, inspecione a mídia concluída antes de usar um tamanho não documentado.

Autorizações

Authorization

string

header

obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data

prompt

string

obrigatório

Text prompt that describes the video. Required. When using reference images, describe what each uploaded image should control, such as the subject from [Image 1], the secondary object from [Image 2], and the background or style from [Image 3]. Also state the action, camera motion, visual style, and scene.

Exemplo:

"A slow cinematic camera push across a coastal landscape at sunrise."

model

enum<string>

obrigatório

Seedance model ID. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

Opções disponíveis:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Exemplo:

"doubao-seedance-2-0-mini"

seconds

integer

padrão:5

Video duration in seconds. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept 4 to 15. Seedance 1.5 Pro accepts 4 to 12, and Seedance 1.0 Pro accepts 2 to 10. The default is 5.

Intervalo necessário: 2 <= x <= 15

Exemplo:

5

size

string

Output size as an exact WxH value. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. Mini does not support 1080p or 4K. A Mini request for 1920x1080 produced 1280x720 in one production check. The standard Seedance 2.0 model also accepts its documented 4K values.

Pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$

Exemplos:

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

file

Optional reference image uploaded as a multipart file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept this field. On routes that support multiple reference images, repeat the field and reference the files in upload order as [Image 1], [Image 2], and so on. Seedance 1.0 Pro and 1.5 Pro do not accept it.

Resposta

Task created. Save the returned id and poll GET /v1/videos/{id}.

string

obrigatório

Task id. Use it as the path parameter for GET /v1/videos/{id}.

object

string

obrigatório

Object type, always video.

model

string

obrigatório

Echo of the requested model id.

status

enum<string>

obrigatório

Initial task status. Newly created tasks are returned as queued.

Opções disponíveis:

queued,

in_progress,

completed,

failed,

error

progress

integer

obrigatório

Completion percentage. 0 at creation.

Intervalo necessário: 0 <= x <= 100

created_at

integer

obrigatório

Task creation time as a Unix timestamp in seconds.

task_id

string

Alias of id returned for compatibility. The value matches id.

APIs de geração de vídeo

Recuperar um vídeo do Seedance

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

Moderação de conteúdo

Chaves de API

IDs de modelos compatíveis

Usar imagens de referência

Duração por modelo

Suporte de tamanho por modelo

Autorizações

Corpo

Resposta

​IDs de modelos compatíveis

​Usar imagens de referência

​Duração por modelo

​Suporte de tamanho por modelo

Autorizações

Corpo

Resposta

IDs de modelos compatíveis

Usar imagens de referência

Duração por modelo

Suporte de tamanho por modelo