Source: https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0/
Canonical: https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0/
Language: pt-pt

# ByteDance: Seedance 2.0

[Markdown](https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0/index.md) · [JSON](https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0/facts.json)

## [ByteDance: Seedance 2.0](https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0/)

O ByteDance Seedance 2.0 combina geração audiovisual nativa com referências de imagem, vídeo e som. Dirija novas cenas, edite filmagens existentes ou prolongue uma sequência; a edição standard inclui saída documentada de 1080p e 4K de 10 bits.

- [**Ailoot Ultra · Vídeo** `POST /v1/videos` `bytedance/seedance-2.0`](https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0/#method-0)

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

O Seedance 2.0 é o modelo standard da ByteDance Seed para criação audiovisual multimodal. Combina texto, imagens, vídeos e áudio numa arquitetura de geração conjunta, com fluxos criativos separados para cenas orientadas por referências, edição de vídeo e prolongamento de vídeo. É útil quando o pedido precisa de uma interpretação coerente e de informação visual ou sonora específica de materiais preparados.

#### Referências multimodais e controlo de realização

As imagens podem definir a aparência do sujeito, o estilo visual e a composição. As referências de vídeo podem orientar ação, movimento de câmara e efeitos. O áudio pode orientar timbre de voz, música ou diálogo. Defina a função de cada material e depois descreva a cena que deve resultar. O fabricante destaca o controlo da interpretação, da iluminação, das sombras e da linguagem de câmara.

Para uma história de produto, prepare uma imagem do produto, uma referência de movimento de câmara e uma indicação sonora. Um pedido pode ser: «Preserve a jarra de vidro azul da Imagem 1. Use o movimento lateral lento de travelling do Vídeo 1. A jarra está numa prateleira ao sol, com música instrumental suave baseada no Áudio 1.» A saída pretendida é uma cena encenada de novo que combina informação selecionada das referências.

As entradas de referência podem combinar imagem e áudio, imagem e vídeo, vídeo e áudio, ou os três. Entrada apenas de áudio e texto com áudio sem imagem ou vídeo não são suportados. Também estão documentados texto para vídeo tradicional, geração com primeiro fotograma e geração com primeiro e último fotogramas. Se forem importantes composições fixas na abertura e no fecho, use o fluxo específico de pontos extremos: nomear uma imagem de referência como ponto extremo num pedido de referências omni é apenas uma forma indireta de o orientar.

#### Edição de filmagens

O modelo pode substituir um sujeito, acrescentar ou remover objetos, alterar elementos e redesenhar ou reparar partes de um vídeo. Descreva a alteração específica e identifique as filmagens de origem. Para uma adição, inclua o momento e a posição de aparecimento; para uma remoção ou substituição, indique o objeto com precisão e nomeie o que deve permanecer.

Por exemplo: «Substitua o candeeiro de secretária do Vídeo 1 pelo candeeiro de latão da Imagem 1. Mantenha o movimento da câmara, a disposição da secretária e a direção da iluminação.» O resultado pretendido é uma versão editada da cena com a substituição prevista. Examine as áreas inalteradas e o novo objeto, sobretudo durante ocultações, movimentos e mudanças de plano.

#### Prolongamento e ligação de uma sequência

O Seedance 2.0 pode prolongar um vídeo para a frente ou para trás e ligar até três clips fornecidos com transições geradas. Especifique a direção temporal e o novo acontecimento. Para uma ligação, ordene os clips e descreva a transição entre cada par, como uma câmara que entra por uma porta num plano e chega ao ambiente seguinte.

Um prolongamento simples devolve normalmente a continuação desenvolvida em torno das filmagens de origem; inclua uma instrução clara se o resultado final também deve repetir o segmento original. Ao completar uma ligação entre dois ou três clips, o fluxo documentado pode incluir tanto material original como novo conteúdo de transição. Isto é útil para desenvolver uma abertura ou um final, ou ligar cenas preparadas sem deixar a ação de ligação por especificar.

#### Saída da edição standard e 4K

A edição standard documenta MP4 a 24 fps e durações de 4 a 15 segundos. Os níveis de saída são 480p, 720p e 1080p com profundidade de cor de 8 bits, mais 4K com profundidade de cor de 10 bits. As proporções suportadas são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16. Também estão documentados enquadramento adaptativo e seleção automática da duração. A edição Fast tem a sua própria especificação de saída mais restrita, de 480p/720p.

A saída 4K usa codificação H.265/HEVC. A codificação de dez bits preserva gradações tonais adicionais e transições de cor mais suaves, o que é relevante para material com gradientes subtis de luz ou cor. Verifique se o ambiente de reprodução e edição pretendido consegue descodificar esse formato; alguns navegadores e dispositivos não o reproduzem diretamente. Um contentor compatível não garante, por si só, descodificação de vídeo compatível.

O modelo pode gerar som sincronizado ou vídeo silencioso e devolver o último fotograma gerado para uma cena posterior. O áudio gerado é mono. A família 2.0 não suporta o modo separado de pré-visualização Draft em duas etapas, pelo que essa funcionalidade não deve ser inferida a partir de outra edição Seedance.

#### Preparação de referências e limites relevantes

A capacidade de referências documentada é de até nove imagens, três vídeos e três clips de áudio. Este perfil documentado do fabricante não aceita carregamentos diretos de imagens ou vídeos de referência com rostos humanos reais; os retratos usam o fluxo de recursos de retrato suportado. Cada clip de vídeo e áudio deve durar 2–15 segundos. Todas as referências de vídeo, juntas, devem caber em 15 segundos, e todas as referências de áudio têm o seu próprio total de 15 segundos. Os ficheiros de vídeo usam MP4 ou MOV a 24–60 fps, até 200 MB cada; os ficheiros de áudio usam WAV ou MP3, até 15 MB cada. Os formatos de imagem enumerados são JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF. As imagens devem ter menos de 30 MB cada e o corpo do pedido não deve exceder 64 MB. No perfil de entrada de referências documentado, a largura e a altura das imagens devem estar ambas estritamente entre 300 e 6000 píxeis, com uma proporção largura/altura estritamente entre 0.4 e 2.5. Os vídeos de referência permitem 300–6000 píxeis em cada dimensão e proporções de 0.4–2.5, inclusive, com 407 696–8 295 044 píxeis no total. Os vídeos MP4 ou MOV usam vídeo H.264/AVC ou H.265/HEVC e áudio AAC ou MP3.

Ordene os ficheiros intencionalmente e refira cada um pelo tipo de conteúdo e número: Imagem 1, Vídeo 1 e Áudio 1. O número segue a ordem entre ficheiros desse tipo. Explique que características transferir e que conteúdo de origem não deve definir a nova cena. Os idiomas documentados para pedidos incluem inglês, espanhol, indonésio, português e japonês. Mantenha o idioma falado consistente dentro de um diálogo; o guia desaconselha misturar idiomas, exceto em nomes próprios. Para trabalho orientado por voz, separe o locutor, a fala exata e a indicação de interpretação.

Prepare a primeira e a última imagens com enquadramento compatível. Uma divergência entre a imagem de entrada e as dimensões de saída pode provocar um recorte ou uma mudança visual abrupta; dimensões coincidentes e enquadramento adaptativo são soluções documentadas. Concentre a descrição no acontecimento e nas funções das referências. O fabricante alerta que pedidos longos podem dispersar a informação, levando a ignorar pormenores. Reveja o movimento resultante, a continuidade das referências, a interpretação áudio e as junções entre cenas como partes distintas do resultado criativo.

#### Planeamento de planos e orientação do texto

Para uma cena complexa, organize o pedido em Plano 1, Plano 2 e Plano 3, especificando por ordem a câmara, a ação do sujeito, a posição e o som. O guia recomenda um movimento de câmara por plano e dar prioridade a ações lentas e ligadas. As marcas temporais precisas por plano são instáveis, pelo que uma sequência de acontecimentos é um controlo melhor do que impor várias janelas temporais exatas.

O modelo também gera texto comum, incluindo slogans, legendas e balões de fala. Pode orientar a cor, o tratamento visual, a localização e a entrada do texto. Use caracteres comuns em vez de caracteres raros ou símbolos especiais e reveja a formulação em movimento. Para referências de sujeitos, associe claramente cada recurso à personagem ou objeto pretendido. Diferentes vistas de produto podem fornecer informação visual diferente; colagens de vistas de personagem podem confundir a identidade facial. A recomendação documentada para referência de personagem é uma imagem de rosto clara e uma de corpo inteiro, separadas.

#### Comportamentos a examinar antes de uma edição

O guia documenta legendas indesejadas, logótipos, personagens duplicadas e desvios de estilo. Materiais de origem limpos, designações consistentes e restrições explícitas reduzem esses riscos, mas não garantem que o texto indesejado ou as figuras duplicadas desapareçam. Mais de quatro pessoas de referência é um risco de estabilidade assinalado, distinto do número de ficheiros que o modelo aceita.

O prolongamento de vídeo pode criar um salto ou recuo na junção e continuações repetidas podem acumular degradação da qualidade da imagem. Examine os fotogramas dos limites e limite a acumulação de prolongamentos sucessivos. Uma voz de referência pode diferir do timbre de origem; a narração pode terminar com um clique ou um corte abrupto, para o qual um desvanecimento do áudio é uma solução documentada. Caracteres chineses polifónicos, pouco comuns ou de forma semelhante podem ser pronunciados incorretamente. Para um efeito animado preciso, como uma contagem decrescente, uma referência de movimento é mais informativa do que um pedido apenas verbal. Estas são razões concretas para verificar separadamente identidade, texto, movimento e som ao selecionar o clip.

**Ailoot Ultra · Vídeo** `POST /v1/videos` `bytedance/seedance-2.0`

[`bytedance/seedance-2.0`](https://ailoot.ai/models/pt-pt/#m=bytedance%2Fseedance-2.0&route=Ultra&caller=bytedance%2Fseedance-2.0&fmt=videos)

ByteDance /`bytedance/seedance-2.0`

### Introdução

O ByteDance Seedance 2.0 combina geração audiovisual nativa com referências de imagem, vídeo e som. Dirija novas cenas, edite filmagens existentes ou prolongue uma sequência; a edição standard inclui saída documentada de 1080p e 4K de 10 bits.

Entradas aceites

Texto · Imagens · Áudio

Resultados

Vídeo

### Disponível no Ailoot · entradas e métodos

**Ailoot Ultra · Vídeo** `POST /v1/videos`

Entrada

`text`, `image`, `audio`

Saída

`video`

Formato de saída

bytes MP4 originais; sem normalização nem transcodificação

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites bytedance/seedance-2.0 | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— |
| Campo`duration` | Tipo`integer` | RequisitoObrigatório | Valores e limites 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predefinição— |
| Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores e limites 480p, 720p, 1080p, 4K | Predefinição— |
| Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Predefinição— |
| Campo`generate_audio` | Tipo`boolean` | RequisitoOpcional | Valores e limites false, true Condições: Em 480p e 720p, omitir generate\_audio seleciona o preço com áudio e false seleciona o preço sem áudio. Em 1080p e 4K, o preço da resolução aplica-se a ambas as definições. Verifique has\_audio no resultado para identificar a faixa de áudio devolvida. | Predefinição— |
| Campo`frame_images` | Tipo`array` | RequisitoOpcional | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 2 Conteúdo de entrada: Matriz de objetos de fotograma. Cada um tem type=image\_url, image\_url com url e frame\_type=first\_frame ou last\_frame. Cada função aparece, no máximo, uma vez. Utilize URLs HTTPS públicos. Chaves exatas: type, image\_url, frame\_type Condições: Estas chaves aplicam-se a cada objeto de fotograma. Omita frame\_images num pedido apenas de texto. | Predefinição— |
| Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores e limites Conteúdo de entrada: Matriz de objetos de referência de imagem ou áudio. Defina type como image\_url ou audio\_url e forneça o objeto URL correspondente com url. Continua a não ser possível calcular o preço de referências de vídeo. Condições: Omita frame\_images para utilizar o modo de referência. Utilize URLs HTTPS públicos. | Predefinição— |
| Campo`size` | Tipo`string` | RequisitoOpcional | Valores e limites 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Padrão: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ | Predefinição— |
| Campo`seed` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: -9 223 372 036 854 775 808 Máximo: 9 223 372 036 854 775 807 | Predefinição— |
| Campo`callback_url` | Tipo`string` | RequisitoOpcional | Valores e limites Padrão: ^https:// | Predefinição— |
| Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`trace` | Tipo`object` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`user` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |

Combinações de materiais de entrada

**Texto para vídeo** · Uma instrução escrita. · Obrigatório: model, prompt, duration

`Forneça uma instrução de texto e uma duração suportada em segundos inteiros. Utilize um tamanho exato enumerado ou uma resolução e uma proporção que correspondam a dimensões enumeradas.`

`model`: Tipo: string · bytedance/seedance-2.0

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

**Imagem para vídeo** · Uma instrução escrita e uma imagem de fotograma. · Obrigatório: model, prompt, duration, frame\_images

`frame_images é uma matriz de objetos com type=image_url, image_url com url e frame_type. Utilize um URL HTTPS público de imagem; first_frame e last_frame podem aparecer uma vez cada. Utilize um tamanho de saída enumerado ou dimensões compatíveis. Não adicione referências de vídeo.`

Chaves exatas: type, image\_url, frame\_type

`model`: Tipo: string · bytedance/seedance-2.0

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

**Reference to video** · Uma instrução escrita e referências de imagem ou áudio. · Obrigatório: model, prompt, duration, input\_references

`input_references é uma matriz. Cada objeto tem type=image_url ou type=audio_url e um objeto URL correspondente com url. Utilize ligações HTTPS públicas. Omita frame_images para selecionar o modo de referência. Não é possível calcular o preço de referências de vídeo.`

`model`: Tipo: string · bytedance/seedance-2.0

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

Parâmetros e ciclo de vida do método

| Parâmetro | Contrato |
| --- | --- |
| Parâmetro`content_type` | Contratoapplication/json |
| Parâmetro`required` | Contratomodel, prompt, duration |
| Parâmetro`material_types` | Contratotext, image, audio |
| Parâmetro`additional_properties` | Contratofalse |
| Parâmetro`optional_controls` | Contratoresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, size, seed, callback\_url, session\_id, trace, user |

Ciclo de vida: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### Tarifários

##### Cálculo do custo final

As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido

Não especificado Quando o modo rápido está selecionado

Modo flex

Não especificado Quando o modo flex está selecionado

Esforço máximo de raciocínio

Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)

#### Tarifas estimadas para comparação

#### Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

| Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Condições de faturação | Custo |
| --- | --- | --- | --- | --- | --- |
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Condições de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação **—** / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação **—** / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação **—** / 1K tokens |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação **$0.014** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoresolution: 1080p | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação **$0.0154** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoentrada: with\_video\_input; resolução: 1080p | Custo reference · Preço por token de vídeo · Estimativa apenas para comparação **$0.0094** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoresolution: 4k | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação **$0.008** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoentrada: with\_video\_input; resolução: 4k | Custo reference · Preço por token de vídeo · Estimativa apenas para comparação **$0.0048** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoentrada: with\_video\_input | Custo reference · Preço por token de vídeo · Estimativa apenas para comparação **$0.0086** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoáudio: without\_audio | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação **$0.014** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$0.3024** estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/)

#### Detalhes da tarifa de referência

As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.

Referências de preços das configurações de vídeo

#### Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

| Configuração | Condições de faturação | Custo |
| --- | --- | --- |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço por token de vídeo **$0.014** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoresolution: 4k | Custo Saída · Preço por token de vídeo **$0.008** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoresolution: 1080p | Custo Saída · Preço por token de vídeo **$0.0154** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoáudio: without\_audio | Custo Saída · Preço por token de vídeo **$0.014** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoentrada: with\_video\_input | Custo reference · Preço por token de vídeo **$0.0086** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoentrada: with\_video\_input; resolução: 4k | Custo reference · Preço por token de vídeo **$0.0048** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoentrada: with\_video\_input; resolução: 1080p | Custo reference · Preço por token de vídeo **$0.0094** por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |

### Exemplos de pedidos

#### Ailoot Ultra · Vídeo

curl · crie um vídeo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Receber e guardar os resultados

#### Ailoot Ultra · Vídeo

URLs assinados para conteúdo pertencente ao utilizador

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Verificar o estado da tarefa

GET estado da operação original

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Outras leituras de conteúdo

Guardar cada saída concluída de que é titular

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.

##### Se for necessário verificar a resposta original

503 result\_pending\_check + id original + X-Should-Retry:false; nunca repita o original

Campos da resposta

| Campo | Tipo | Significado |
| --- | --- | --- |
| Campo`index` | Tipointeger | SignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero. |
| Campo`content_url` | Tipostring | SignificadoURL HTTPS assinado para transferir este vídeo concluído. |
| Campo`sha256` | Tipostring \| null | SignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível. |
| Campo`size_bytes` | Tipointeger \| null | SignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível. |
| Campo`duration_ms` | Tipointeger \| null | SignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível. |
| Campo`width` | Tipointeger \| null | SignificadoLargura do vídeo em píxeis; null se não estiver disponível. |
| Campo`height` | Tipointeger \| null | SignificadoAltura do vídeo em píxeis; null se não estiver disponível. |
| Campo`video_codec` | Tipostring \| null | SignificadoIdentificador do codec de vídeo; null se não estiver registado. |
| Campo`has_audio` | Tipoboolean \| null | SignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido. |
| Campo`audio_codec` | Tipostring \| null | SignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador. |

Erros e passos seguintes

| Resposta | Condição | Passo seguinte |
| --- | --- | --- |
| Resposta404 · `not_found_error` | CondiçãoO acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado. | Passo seguinteVerifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API. |
| Resposta401 · `authentication_error` | CondiçãoA chave API não corresponde à conta autenticada. | Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar. |
| Resposta400 · `invalid_request_error` | CondiçãoNão foi possível ler o pedido ou o índice de transferência é inválido. | Passo seguinteCorrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original. |
| Resposta422 · `price_unavailable` | CondiçãoNão é possível calcular o preço da configuração de vídeo selecionada. | Passo seguinteEscolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido. |
| Resposta422 · `invalid_request_error` | CondiçãoUma entrada de vídeo ou a tarefa original de continuação é inválida. | Passo seguinteUtilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API. |
| Resposta402 · `billing_error` | CondiçãoO saldo disponível ou os limites não permitem efetuar uma reserva. | Passo seguinteVerifique o saldo disponível e os limites antes de enviar um novo pedido. |
| Resposta503 · `server_error` | CondiçãoA verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível. | Passo seguinteAguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração. |
| Resposta503 · `result_pending_check` | CondiçãoO resultado e a cobrança do vídeo original precisam de verificação. | Passo seguinteConserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada. |
| Resposta503 · `owned_result_unavailable` | CondiçãoA transferência do vídeo existente está temporariamente indisponível. | Passo seguinteConsulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada. |
| Resposta409 · `video_not_ready` | CondiçãoO conteúdo do vídeo não foi publicado. | Passo seguinteConsulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança. |

### Aliases

#### Aliases do modelo

**Ailoot Ultra** [`bytedance/seedance-2.0`](https://ailoot.ai/models/pt-pt/#m=bytedance%2Fseedance-2.0&route=Ultra&caller=bytedance%2Fseedance-2.0&fmt=videos)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`bytedance/seedance-2.0`](https://ailoot.ai/models/pt-pt/#m=bytedance%2Fseedance-2.0&route=Ultra&caller=bytedance%2Fseedance-2.0&fmt=videos)

FAQ · ByteDance: Seedance 2.0

Que entradas e resultados estão disponíveis?

`POST /v1/videos` · `bytedance/seedance-2.0`: `text`, `image`, `audio` → `video`

Que campos utiliza o pedido?

`POST /v1/videos` · `bytedance/seedance-2.0`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `size`, `seed`, `callback_url`, `session_id`, `trace`, `user`

Que limites se aplicam?

`POST /v1/videos` · `bytedance/seedance-2.0`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

## A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

## Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição

Escolha um plano com desconto para os pedidos regulares.

Código promocional até 50%

Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.

Custos no histórico

O modelo, os tokens e o montante são guardados para cada pedido.

[Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/)

## Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial

Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.

Licença de revendedor

Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.

Documentos no site

A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

[Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.