Criar um vídeo Seedance

Defina size como um valor WxH da tabela de tamanhos para seu modelo.

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

IDs de modelo compatíveis

Escolha um modelo para seu modo de entrada e resolução e envie o ID exato dele no campo model.

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

Usar imagens de referência

Envie POST /v1/videos como multipart/form-data, com imagens de referência em input_reference. Para várias imagens, repita o campo na ordem das imagens, com uma URL HTTPS de imagem acessível publicamente ou um arquivo de imagem enviado por campo. Use somente URLs ou somente arquivos nesse campo. Envie cada URL separadamente, em vez de unir URLs com vírgulas. Mantenha cada imagem enviada com tamanho igual ou inferior a 20 MiB (20 × 1024 × 1024 bytes). Seedance 1.0 Pro e 1.5 Pro usam uma imagem de referência. Seedance 2.0, Fast e Mini aceitam até 9 imagens de referência. Seedance 2.5 aceita até 30 imagens de referência. Essas quantidades se aplicam tanto a URLs quanto a arquivos enviados. No prompt, atribua a cada imagem uma função, como o assunto, o cenário ou o estilo visual. Descreva a aparência a preservar, a ação e o movimento da câmera. Os exemplos de solicitação no início desta página mostram entradas de URL de imagem e envios de uma ou várias imagens.

Enviar URLs de imagens de referência

Use duas URLs de imagem para orientar a aparência do assunto e o cenário:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Use a slow camera push-in and natural motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'input_reference=https://your-image-host/setting.png'

Use vídeos e áudios de referência

Seedance 2.0, Fast, Mini e 2.5 aceitam reference_videos e reference_audios. Use arquivos MP4 para referências de vídeo e arquivos MP3 para referências de áudio. Envie cada um como uma URL HTTPS acessível publicamente ou como um arquivo carregado. Combine o áudio de referência com pelo menos uma imagem ou um vídeo. No Prompt, use @Image1, @Video1 e @Audio1 para atribuir funções às suas referências. Numere as referências pela ordem delas em cada tipo de mídia. Você pode combinar URLs e uploads em campos diferentes. Em cada um de input_reference, reference_videos e reference_audios, use somente URLs ou somente arquivos. Para várias entradas, repita o campo uma vez para cada entrada, em vez de separar URLs com vírgulas.

Família de modelos	Imagens de referência	Vídeos de referência	Áudio de referência	Total de entradas de referência
Seedance 2.0, Fast e Mini	Até 9 URLs ou arquivos em `input_reference`	Até 3	Até 3	Até 12
Seedance 2.5	Até 30 URLs ou arquivos em `input_reference`	Até 10 URLs ou 5 arquivos	Até 10 URLs ou 5 arquivos	Até 50

Mantenha cada vídeo carregado com até 50 MiB e cada arquivo de áudio carregado com até 15 MiB. Um MiB equivale a 1024 × 1024 bytes. O Seedance 2.0 padrão (doubao-seedance-2-0) tem limites adicionais de mídia para URLs e arquivos carregados. Para vídeos de referência, mantenha a duração combinada entre 2 e 15 segundos e o tamanho total abaixo de 50 MB. Use uma resolução de vídeo de referência de aproximadamente 480p (640x640) a 720p (834x1112). Para áudio de referência, mantenha a duração combinada em até 15 segundos e cada arquivo em até 15 MB. A mídia carregada também deve atender aos limites de upload por arquivo acima.

Envie uma URL de vídeo de referência

Use o vídeo de referência para orientar o movimento da câmera e a ação:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Follow the camera movement and action in @Video1. Preserve the direction and pace of the motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'reference_videos=https://your-media-host/reference.mp4'

Combine uma URL de imagem com áudio

Anime o assunto de referência no ritmo do áudio de referência:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Animate the subject in @Image1 to the rhythm of @Audio1. Preserve the subject appearance and use a fixed camera.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'reference_audios=https://your-media-host/reference.mp3'

Carregue mídia de referência com o Seedance 2.5

Carregue duas imagens, um vídeo MP4 e um arquivo de áudio MP3 em uma única solicitação:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=seedance-2-5' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Follow the motion in @Video1 and the rhythm of @Audio1.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form 'input_reference=@/path/to/subject.png;type=image/png' \
  --form 'input_reference=@/path/to/setting.png;type=image/png' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

Duração por modelo

Defina seconds como um valor inteiro dentro do intervalo do seu modelo. Se você omiti-lo, a CometAPI solicitará um clipe de 5 segundos.

Família de modelos	Compatível `seconds`	Padrão	Comportamento nos limites
Seedance 2.5	`4`-`30`	`5`	Use segundos inteiros dentro do intervalo.
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 a tamanho por modelo

Seedance 2.5

Para o Seedance 2.5, estes valores de WxH se aplicam tanto a prompts de texto quanto a mídias de referência.

Classe de resolução	`16:9`	`4:3`	`1:1`	`3:4`	`9:16`	`21:9`
`480p`	`854x480`	`752x560`	`640x640`	`560x752`	`480x854`	`992x432`
`720p`	`1280x720`	`1112x834`	`960x960`	`834x1112`	`720x1280`	`1470x630`

Modelos Seedance anteriores

A coluna final agrupa valores exatos de WxH para Seedance 1.5 Pro, Seedance 2.0 padrão e Fast. O Seedance 2.0 Fast usa apenas os valores 480p e 720p nessa coluna. Os valores de 1080p nessa coluna se aplicam ao Seedance 1.5 Pro e ao Seedance 2.0 padrão. Os valores de 4K se aplicam 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 de aspecto	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. Defina size como um valor WxH da coluna Mini.

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 image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. 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:

seedance-2-5,

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.5 accepts 4 to 30. 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 <= 30

Exemplo:

5

size

string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. 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:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

Exemplo:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

Exemplo:

"https://your-media-host/reference.mp3"

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.

Moderação de conteúdo

Chaves de API

IDs de modelo compatíveis

Usar imagens de referência

Enviar URLs de imagens de referência

Use vídeos e áudios de referência

Envie uma URL de vídeo de referência

Combine uma URL de imagem com áudio

Carregue mídia de referência com o Seedance 2.5

Duração por modelo

Suporte a tamanho por modelo

Seedance 2.5

Modelos Seedance anteriores

Autorizações

Corpo

Resposta

​IDs de modelo compatíveis

​Usar imagens de referência

​Enviar URLs de imagens de referência

​Use vídeos e áudios de referência

​Envie uma URL de vídeo de referência

​Combine uma URL de imagem com áudio

​Carregue mídia de referência com o Seedance 2.5

​Duração por modelo

​Suporte a tamanho por modelo

​Seedance 2.5

​Modelos Seedance anteriores

Autorizações

Corpo

Resposta

IDs de modelo compatíveis

Usar imagens de referência

Enviar URLs de imagens de referência

Use vídeos e áudios de referência

Envie uma URL de vídeo de referência

Combine uma URL de imagem com áudio

Carregue mídia de referência com o Seedance 2.5

Duração por modelo

Suporte a tamanho por modelo

Seedance 2.5

Modelos Seedance anteriores