API de vídeo do Seedance: modelos, campos e requisitos de mídia
Conecte o Seedance com sua BetterToken API Key e escolha campos, mídias e métodos de geração conforme o Model ID e a operação.
Você pode gerar vídeos a partir de texto, um quadro inicial ou mídias de referência. Os quatro modelos da região da China aceitam três operações de geração; os dois SR aceitam texto para vídeo e imagem para vídeo com um único quadro inicial. Escolha o Model ID conforme a operação, a duração e o nível de saída necessários.
Prepare sua BetterToken API Key. A Base URL é https://bettertoken.ai/v1 e a autenticação usa Authorization: Bearer YOUR_API_KEY. Copie o Model ID exatamente, respeitando maiúsculas e minúsculas.
Cada request.json desta página segue o mesmo fluxo: solicite a cotação, confirme a criação, consulte o estado e baixe o vídeo. A cotação não inicia a geração; a criação envia uma tarefa paga. Consulte os preços atuais na model plaza.
Modelos e operações
A tabela lista as opções de cada operação. Consulte os valores padrão, as quantidades de mídia e as restrições de combinação em cada seção. Os tamanhos usam 1 MB = 1048576 bytes.
| Model ID | Operação | Duração (segundos) | Nível de saída | Proporção | Áudio | Funções de mídia |
|---|---|---|---|---|---|---|
ByteDance-Seedance-2.0-SR | image_to_video | 5–10, incremento 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.0-SR | text_to_video | 5–10, incremento 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Nenhum |
ByteDance-Seedance-2.5-SR | image_to_video | 5–10, incremento 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.5-SR | text_to_video | 5–10, incremento 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Nenhum |
doubao-seedance-2-0-260128 | image_to_video | 4–15, incremento 1; aceita auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-260128 | reference_to_video | 4–15, incremento 1; aceita auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-260128 | text_to_video | 4–15, incremento 1; aceita auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Nenhum |
doubao-seedance-2-0-fast-260128 | image_to_video | 4–15, incremento 1; aceita auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-fast-260128 | reference_to_video | 4–15, incremento 1; aceita auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-fast-260128 | text_to_video | 4–15, incremento 1; aceita auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Nenhum |
doubao-seedance-2-0-mini-260615 | image_to_video | 4–15, incremento 1; aceita auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-mini-260615 | reference_to_video | 4–15, incremento 1; aceita auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-mini-260615 | text_to_video | 4–15, incremento 1; aceita auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Nenhum |
doubao-seedance-2-5-260628 | image_to_video | 4–30, incremento 1; aceita auto | 480p, 720p, 1080p | adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-5-260628 | reference_to_video | 4–30, incremento 1; aceita auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-5-260628 | text_to_video | 4–30, incremento 1; aceita auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Nenhum |
Os dois modelos SR aceitam apenas durações fixas de 5 ou 10 segundos. Os modelos da região da China e os SR têm Model IDs diferentes; não aplique os campos nem os limites de mídia de um modelo a outro.
Mídias de exemplo
Os exemplos de geração a partir de imagens e referências usam uma caneca de cerâmica azul sobre uma mesa branca. Você pode testar com a imagem de exemplo ou substituí-la primeiro por mídias HTTPS públicas que tenha direito de usar e que atendam aos limites desta página.

De texto para vídeo
ByteDance-Seedance-2.0-SR
Use esta operação para gerar um vídeo quando tiver apenas uma descrição em texto.
Defina model com o Model ID desta seção e operation como text_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed | fixed |
duration.seconds | integer | Não | 5–10, incremento 5 s; apenas com duração fixa | 5 |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 720p, 1080p, 4k | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false | false |
Requisitos das mídias
Esta operação não aceita mídias.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
ByteDance-Seedance-2.5-SR
Use esta operação para gerar um vídeo quando tiver apenas uma descrição em texto.
Defina model com o Model ID desta seção e operation como text_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed | fixed |
duration.seconds | integer | Não | 5–10, incremento 5 s; apenas com duração fixa | 5 |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 720p, 1080p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false | false |
Requisitos das mídias
Esta operação não aceita mídias.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
doubao-seedance-2-0-260128
Use esta operação para gerar um vídeo quando tiver apenas uma descrição em texto.
Defina model com o Model ID desta seção e operation como text_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
Esta operação não aceita mídias.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
doubao-seedance-2-0-fast-260128
Use esta operação para gerar um vídeo quando tiver apenas uma descrição em texto.
Defina model com o Model ID desta seção e operation como text_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
Esta operação não aceita mídias.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
doubao-seedance-2-0-mini-260615
Use esta operação para gerar um vídeo quando tiver apenas uma descrição em texto.
Defina model com o Model ID desta seção e operation como text_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
Esta operação não aceita mídias.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
doubao-seedance-2-5-260628
Use esta operação para gerar um vídeo quando tiver apenas uma descrição em texto.
Defina model com o Model ID desta seção e operation como text_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | auto |
duration.seconds | integer | Não | 4–30, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p, 1080p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
Esta operação não aceita mídias.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-5-260628", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
De imagem para vídeo
ByteDance-Seedance-2.0-SR
Use esta operação para definir o quadro inicial ou os quadros inicial e final a partir de imagens.
Defina model com o Model ID desta seção e operation como image_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed | fixed |
duration.seconds | integer | Não | 5–10, incremento 5 s; apenas com duração fixa | 5 |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 720p, 1080p, 4k | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
first_frame | image, 1 (obrigatório) | jpeg, png, webp | Tamanho máximo: 10 MB; largura: 128–4096 px; altura: 128–4096 px |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Você deve fornecer
first_frame.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
ByteDance-Seedance-2.5-SR
Use esta operação para definir o quadro inicial ou os quadros inicial e final a partir de imagens.
Defina model com o Model ID desta seção e operation como image_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed | fixed |
duration.seconds | integer | Não | 5–10, incremento 5 s; apenas com duração fixa | 5 |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 720p, 1080p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
first_frame | image, 1 (obrigatório) | jpeg, png, webp | Tamanho máximo: 10 MB; largura: 128–4096 px; altura: 128–4096 px |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Você deve fornecer
first_frame.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-0-260128
Use esta operação para definir o quadro inicial ou os quadros inicial e final a partir de imagens.
Defina model com o Model ID desta seção e operation como image_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
first_frame | image, 1 (obrigatório) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
last_frame | image, opcional, no máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Você deve fornecer
first_frame.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-0-fast-260128
Use esta operação para definir o quadro inicial ou os quadros inicial e final a partir de imagens.
Defina model com o Model ID desta seção e operation como image_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
first_frame | image, 1 (obrigatório) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
last_frame | image, opcional, no máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Você deve fornecer
first_frame.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-0-mini-260615
Use esta operação para definir o quadro inicial ou os quadros inicial e final a partir de imagens.
Defina model com o Model ID desta seção e operation como image_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
first_frame | image, 1 (obrigatório) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
last_frame | image, opcional, no máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Você deve fornecer
first_frame.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-5-260628
Use esta operação para definir o quadro inicial ou os quadros inicial e final a partir de imagens.
Defina model com o Model ID desta seção e operation como image_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | auto |
duration.seconds | integer | Não | 4–30, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p, 1080p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
first_frame | image, 1 (obrigatório) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
last_frame | image, opcional, no máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Você deve fornecer
first_frame. - Esta operação exige
output.aspect_ratio="adaptive", tanto com apenas o quadro inicial quanto com os quadros inicial e final.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-5-260628", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
Geração com referências
doubao-seedance-2-0-260128
Use esta operação para preservar características do sujeito ou do movimento com mídias de referência.
Defina model com o Model ID desta seção e operation como reference_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
reference_image | image, opcional, no máximo 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
reference_video | video, opcional, no máximo 3 | mp4, mov | Tamanho máximo: 200 MB; largura: 300–6000 px; altura: 300–6000 px; duração: 2–15 s; taxa de quadros mínima: 24 fps; máxima: 60 fps; duração total máxima desta função: 15 s |
reference_audio | audio, opcional, no máximo 3 | wav, mp3 | Tamanho máximo: 15 MB; duração: 2–15 s; duração total máxima desta função: 15 s |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Forneça pelo menos uma destas funções:
reference_image,reference_video,reference_audio. - O áudio de referência não pode ser usado sozinho; inclua também imagens ou vídeos de referência.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-0-fast-260128
Use esta operação para preservar características do sujeito ou do movimento com mídias de referência.
Defina model com o Model ID desta seção e operation como reference_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
reference_image | image, opcional, no máximo 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
reference_video | video, opcional, no máximo 3 | mp4, mov | Tamanho máximo: 200 MB; largura: 300–6000 px; altura: 300–6000 px; duração: 2–15 s; taxa de quadros mínima: 24 fps; máxima: 60 fps; duração total máxima desta função: 15 s |
reference_audio | audio, opcional, no máximo 3 | wav, mp3 | Tamanho máximo: 15 MB; duração: 2–15 s; duração total máxima desta função: 15 s |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Forneça pelo menos uma destas funções:
reference_image,reference_video,reference_audio. - O áudio de referência não pode ser usado sozinho; inclua também imagens ou vídeos de referência.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-0-mini-260615
Use esta operação para preservar características do sujeito ou do movimento com mídias de referência.
Defina model com o Model ID desta seção e operation como reference_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | fixed |
duration.seconds | integer | Não | 4–15, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
reference_image | image, opcional, no máximo 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
reference_video | video, opcional, no máximo 3 | mp4, mov | Tamanho máximo: 200 MB; largura: 300–6000 px; altura: 300–6000 px; duração: 2–15 s; taxa de quadros mínima: 24 fps; máxima: 60 fps; duração total máxima desta função: 15 s |
reference_audio | audio, opcional, no máximo 3 | wav, mp3 | Tamanho máximo: 15 MB; duração: 2–15 s; duração total máxima desta função: 15 s |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Forneça pelo menos uma destas funções:
reference_image,reference_video,reference_audio. - O áudio de referência não pode ser usado sozinho; inclua também imagens ou vídeos de referência.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
doubao-seedance-2-5-260628
Use esta operação para preservar características do sujeito ou do movimento com mídias de referência.
Defina model com o Model ID desta seção e operation como reference_to_video. Use apenas os campos de geração da tabela abaixo; coloque as mídias no array media.
| Campo | Tipo | Obrigatório | Opções ou intervalo | Padrão |
|---|---|---|---|---|
audio.mode | string | Não | on, off | on |
duration.mode | string | Não | fixed, auto | auto |
duration.seconds | integer | Não | 4–30, incremento 1 s; apenas com duração fixa | Nenhum |
output.aspect_ratio | string | Não | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Não | mp4 | mp4 |
output.resolution | string | Não | 480p, 720p, 1080p | 720p |
prompt | string | Sim | String | Nenhum |
watermark | boolean | Não | false, true | false |
Requisitos das mídias
| Função da mídia | Tipo e quantidade | Formatos | Limites por arquivo |
|---|---|---|---|
reference_image | image, opcional, no máximo 30 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamanho: 1–31457279 bytes; largura: 300–6000 px; altura: 300–6000 px |
reference_video | video, opcional, no máximo 10 | mp4, mov | Tamanho máximo: 200 MB; largura: 300–6000 px; altura: 300–6000 px; duração: 2–30 s; taxa de quadros mínima: 24 fps; máxima: 60 fps; duração total máxima desta função: 30 s |
reference_audio | audio, opcional, no máximo 10 | wav, mp3 | Tamanho máximo: 15 MB; duração: 2–30 s; duração total máxima desta função: 30 s |
A obrigatoriedade das mídias também depende das restrições de combinação abaixo.
Restrições de combinação
duration.mode="fixed"exigeduration.seconds. Ao informarfixedexplicitamente, inclua também os segundos.- Com
duration.mode="auto", não envieduration.seconds. - Forneça pelo menos uma destas funções:
reference_image,reference_video,reference_audio.
Exemplo de solicitação
Salve o JSON abaixo como request.json e siga o fluxo geral: solicite a cotação e confirme antes de criar a tarefa.
{ "model": "doubao-seedance-2-5-260628", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Erros 422 comuns
| Código de erro 422 | Solução |
|---|---|
enum / range / step | Ajuste os valores e o incremento conforme a tabela de campos desta seção. |
unsupported_field | Remova os campos que não constam na tabela desta operação. |
requires | Complete os segundos, a proporção, o áudio ou as mídias conforme as restrições desta seção. |
excludes | Remova os campos que entrem em conflito com a duração automática ou o quadro final. |
count / media_role | Ajuste as funções e quantidades conforme a tabela de mídias desta seção. |
video_input_unsupported | Verifique a URL HTTPS pública, o Content-Type e o formato do arquivo e solicite uma nova cotação. |
Documentação oficial
Ao chamar a BetterToken, use os campos desta página e a operação correspondente do catálogo de modelos em tempo real.

