{ "aboutHtml": "

O Seedance 2.0 Mini é um modelo com designação própria na família audiovisual Seedance 2.0 da ByteDance. O fabricante documenta texto para vídeo, imagem para vídeo com primeiro fotograma ou com primeiro e último fotogramas, geração com referências multimodais, edição de vídeo e prolongamento de vídeo. O som pode ser gerado em conjunto com a imagem. Escolha o modo de criação conforme o material que já tem: um pedido escrito, uma imagem inicial fixa, dois fotogramas de limite ou um clip que precisa de edição ou continuação.

O Mini tem o seu próprio perfil de saída. O fabricante indica vídeo de 480p e 720p, com cor de 8 bits, 24 fotogramas por segundo e saída MP4. As proporções suportadas são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; a duração de geração documentada é de 4–15 segundos. O controlo de duração do fabricante também permite seleção automática dentro desse intervalo. As opções de 1080p e 4K do modelo Seedance 2.0 completo são separadas; não são definições do Mini. A tabela de capacidades da família enumera a devolução do último fotograma gerado, enquanto o modo Draft não é suportado.

A referência omni cria uma cena nova usando informação selecionada dos materiais fornecidos. Uma imagem pode definir a aparência de um sujeito, a composição ou o tratamento visual. Um vídeo pode estabelecer ação, movimento de câmara ou um efeito; uma referência de áudio pode estabelecer timbre de voz, melodia ou conteúdo falado. Diga ao modelo o que deve retirar de cada referência, em vez de pedir a cópia de todas as propriedades. Por exemplo, use uma fotografia de produto para a forma e a cor, um clip curto de movimento de câmara para a aproximação e uma referência sonora para a atmosfera.

O fluxo da família permite até nove imagens de referência, três clips de vídeo e três clips de áudio. As referências de vídeo têm 2–15 segundos cada, com um máximo total de 15 segundos; as referências de áudio usam os mesmos limites por clip e de duração total. Áudio isolado e texto com áudio sem referência visual não são combinações de referências suportadas. A criação apenas com texto é um modo separado suportado. Para uma sequência, forneça os recursos na ordem pretendida e refira-os de forma consistente como Imagem 1, Vídeo 1 ou Áudio 1, usando a ordem dentro de cada tipo de conteúdo. Não substitua uma referência numerada no pedido escrito por um identificador de recurso.

Uma imagem de primeiro fotograma define a abertura de um plano orientado por imagem. O modo de primeiro e último fotogramas define ambos os limites. Se essas imagens exatas de limite forem importantes, selecione esse modo específico, em vez de descrever referências como abertura e final num pedido de referências omni. Esta última opção é um efeito orientado pelo pedido e não equivale à escolha rigorosa de fotogramas de limite. Prepare as imagens para a composição de saída e indique a ação que liga as situações inicial e final.

A edição de vídeo altera um clip existente, em vez de o usar apenas como inspiração. Identifique o vídeo a editar, o objeto ou a região a alterar, o momento e a posição em que aparece e os pormenores a preservar. Um pedido útil é: «No Vídeo 1, substitua a caneca pelo recipiente mostrado na Imagem 1; preserve o movimento da mão, o enquadramento, a iluminação e a disposição da mesa.» Para remoção, nomeie o objeto indesejado e os elementos envolventes que devem permanecer. O fabricante aconselha a referir diretamente o vídeo de destino para edição ou prolongamento; descrevê-lo como referência pode antes transmitir um pedido de geração de uma cena nova.

O prolongamento de vídeo acrescenta acontecimentos antes ou depois de um clip existente. Descreva a direção da continuação e o que acontece a seguir ou anteriormente. O fluxo documentado também pode ligar dois ou três clips com transições geradas; os três vídeos de entrada, em conjunto, continuam sujeitos ao limite de referências de 15 segundos. O tutorial distingue uma continuação que inclui sobretudo filmagens dos limites do clip original de um pedido que mantém explicitamente o conteúdo original. Indique a composição pretendida do resultado: apenas a continuação, ou uma cena que contenha o clip fornecido e a nova ação.

Para uma orientação clara, separe a descrição da cena estável da sequência de acontecimentos. Defina cada sujeito com duas ou três características visuais distintivas e uma designação consistente. Depois descreva ações, cenário, iluminação, movimento de câmara, estilo visual e restrições. Num diálogo, associe cada fala ao respetivo locutor e à ação relevante. Use designações de planos ordenadas, em vez de tratar marcas temporais exatas como controlos fiáveis: o fabricante observa que os tempos precisos podem ser instáveis. Um pedido de produto encenado pode ser: «A Imagem 1 define o Produto A. Plano 1: aproxime-se lentamente do Produto A no balcão. Plano 2: uma mão roda-o na direção da luz. Plano 3: estabilize sobre o rótulo frontal. Ambiente sonoro suave da sala; preserve as letras impressas.»

Prepare as referências de acordo com as regras de entrada documentadas para a família. Os formatos de imagem suportados incluem JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; cada imagem deve ter menos de 30 MB. O guia exige largura e altura de imagem estritamente entre 300 e 6000 píxeis e uma proporção estritamente entre 0.4 e 2.5. As referências de vídeo usam MP4 ou MOV com vídeo H.264 ou H.265 e áudio AAC ou MP3, têm no máximo 200 MB cada e 24–60 fotogramas por segundo. A largura e a altura são de 300–6000 píxeis, a proporção é de 0.4–2.5 e o número total de píxeis é de 407 696–8 295 044. As referências de áudio usam WAV ou MP3 e têm no máximo 15 MB cada. Estas são especificações de preparação de entradas do fabricante, distintas dos controlos de carregamento de uma aplicação específica.

O fluxo de retratos do fabricante exige uma preparação específica para imagens ou vídeos com rostos humanos reais: os carregamentos diretos de referências não são o percurso normalmente suportado. Documenta saídas de modelos de confiança, personagens digitais predefinidas e um fluxo autorizado de recursos de pessoas reais como soluções separadas. A correspondência de voz, a pronúncia e o som no limite de um clip também precisam de ser examinados. O guia de pedidos recomenda descrever as características de voz pretendidas e manter o estilo do diálogo próximo da referência de áudio. Reveja no artefacto final a consistência dos sujeitos, as palavras exatas pronunciadas, os tempos da ação, as transições de fotogramas e o áudio final; refine o elemento específico que diverge do pedido.

", "aboutText": "O Seedance 2.0 Mini é um modelo com designação própria na família audiovisual Seedance 2.0 da ByteDance. O fabricante documenta texto para vídeo, imagem para vídeo com primeiro fotograma ou com primeiro e último fotogramas, geração com referências multimodais, edição de vídeo e prolongamento de vídeo. O som pode ser gerado em conjunto com a imagem. Escolha o modo de criação conforme o material que já tem: um pedido escrito, uma imagem inicial fixa, dois fotogramas de limite ou um clip que precisa de edição ou continuação.\n\nO Mini tem o seu próprio perfil de saída. O fabricante indica vídeo de 480p e 720p, com cor de 8 bits, 24 fotogramas por segundo e saída MP4. As proporções suportadas são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; a duração de geração documentada é de 4–15 segundos. O controlo de duração do fabricante também permite seleção automática dentro desse intervalo. As opções de 1080p e 4K do modelo Seedance 2.0 completo são separadas; não são definições do Mini. A tabela de capacidades da família enumera a devolução do último fotograma gerado, enquanto o modo Draft não é suportado.\n\nA referência omni cria uma cena nova usando informação selecionada dos materiais fornecidos. Uma imagem pode definir a aparência de um sujeito, a composição ou o tratamento visual. Um vídeo pode estabelecer ação, movimento de câmara ou um efeito; uma referência de áudio pode estabelecer timbre de voz, melodia ou conteúdo falado. Diga ao modelo o que deve retirar de cada referência, em vez de pedir a cópia de todas as propriedades. Por exemplo, use uma fotografia de produto para a forma e a cor, um clip curto de movimento de câmara para a aproximação e uma referência sonora para a atmosfera.\n\nO fluxo da família permite até nove imagens de referência, três clips de vídeo e três clips de áudio. As referências de vídeo têm 2–15 segundos cada, com um máximo total de 15 segundos; as referências de áudio usam os mesmos limites por clip e de duração total. Áudio isolado e texto com áudio sem referência visual não são combinações de referências suportadas. A criação apenas com texto é um modo separado suportado. Para uma sequência, forneça os recursos na ordem pretendida e refira-os de forma consistente como Imagem 1, Vídeo 1 ou Áudio 1, usando a ordem dentro de cada tipo de conteúdo. Não substitua uma referência numerada no pedido escrito por um identificador de recurso.\n\nUma imagem de primeiro fotograma define a abertura de um plano orientado por imagem. O modo de primeiro e último fotogramas define ambos os limites. Se essas imagens exatas de limite forem importantes, selecione esse modo específico, em vez de descrever referências como abertura e final num pedido de referências omni. Esta última opção é um efeito orientado pelo pedido e não equivale à escolha rigorosa de fotogramas de limite. Prepare as imagens para a composição de saída e indique a ação que liga as situações inicial e final.\n\nA edição de vídeo altera um clip existente, em vez de o usar apenas como inspiração. Identifique o vídeo a editar, o objeto ou a região a alterar, o momento e a posição em que aparece e os pormenores a preservar. Um pedido útil é: «No Vídeo 1, substitua a caneca pelo recipiente mostrado na Imagem 1; preserve o movimento da mão, o enquadramento, a iluminação e a disposição da mesa.» Para remoção, nomeie o objeto indesejado e os elementos envolventes que devem permanecer. O fabricante aconselha a referir diretamente o vídeo de destino para edição ou prolongamento; descrevê-lo como referência pode antes transmitir um pedido de geração de uma cena nova.\n\nO prolongamento de vídeo acrescenta acontecimentos antes ou depois de um clip existente. Descreva a direção da continuação e o que acontece a seguir ou anteriormente. O fluxo documentado também pode ligar dois ou três clips com transições geradas; os três vídeos de entrada, em conjunto, continuam sujeitos ao limite de referências de 15 segundos. O tutorial distingue uma continuação que inclui sobretudo filmagens dos limites do clip original de um pedido que mantém explicitamente o conteúdo original. Indique a composição pretendida do resultado: apenas a continuação, ou uma cena que contenha o clip fornecido e a nova ação.\n\nPara uma orientação clara, separe a descrição da cena estável da sequência de acontecimentos. Defina cada sujeito com duas ou três características visuais distintivas e uma designação consistente. Depois descreva ações, cenário, iluminação, movimento de câmara, estilo visual e restrições. Num diálogo, associe cada fala ao respetivo locutor e à ação relevante. Use designações de planos ordenadas, em vez de tratar marcas temporais exatas como controlos fiáveis: o fabricante observa que os tempos precisos podem ser instáveis. Um pedido de produto encenado pode ser: «A Imagem 1 define o Produto A. Plano 1: aproxime-se lentamente do Produto A no balcão. Plano 2: uma mão roda-o na direção da luz. Plano 3: estabilize sobre o rótulo frontal. Ambiente sonoro suave da sala; preserve as letras impressas.»\n\nPrepare as referências de acordo com as regras de entrada documentadas para a família. Os formatos de imagem suportados incluem JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; cada imagem deve ter menos de 30 MB. O guia exige largura e altura de imagem estritamente entre 300 e 6000 píxeis e uma proporção estritamente entre 0.4 e 2.5. As referências de vídeo usam MP4 ou MOV com vídeo H.264 ou H.265 e áudio AAC ou MP3, têm no máximo 200 MB cada e 24–60 fotogramas por segundo. A largura e a altura são de 300–6000 píxeis, a proporção é de 0.4–2.5 e o número total de píxeis é de 407 696–8 295 044. As referências de áudio usam WAV ou MP3 e têm no máximo 15 MB cada. Estas são especificações de preparação de entradas do fabricante, distintas dos controlos de carregamento de uma aplicação específica.\n\nO fluxo de retratos do fabricante exige uma preparação específica para imagens ou vídeos com rostos humanos reais: os carregamentos diretos de referências não são o percurso normalmente suportado. Documenta saídas de modelos de confiança, personagens digitais predefinidas e um fluxo autorizado de recursos de pessoas reais como soluções separadas. A correspondência de voz, a pronúncia e o som no limite de um clip também precisam de ser examinados. O guia de pedidos recomenda descrever as características de voz pretendidas e manter o estilo do diálogo próximo da referência de áudio. Reveja no artefacto final a consistência dos sujeitos, as palavras exatas pronunciadas, os tempos da ação, as transições de fotogramas e o áudio final; refine o elemento específico que diverge do pedido.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a1b46ab53a4533cfefc60e7f9ba982e3bbccf1dffebf6f32c3196d89af202d1d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Mini

ByteDance /bytedance/seedance-2.0-mini

Introdução

O Seedance 2.0 Mini cria vídeos curtos com som gerado opcional a partir de texto e referências de imagem, vídeo e áudio. Suporta criação de cenas, edições direcionadas de vídeo e continuação, com um perfil de saída documentado de 480p ou 720p.

Entradas aceites
Texto · Imagens · Áudio
Resultados
Vídeo
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 Mini é um modelo com designação própria na família audiovisual Seedance 2.0 da ByteDance. O fabricante documenta texto para vídeo, imagem para vídeo com primeiro fotograma ou com primeiro e último fotogramas, geração com referências multimodais, edição de vídeo e prolongamento de vídeo. O som pode ser gerado em conjunto com a imagem. Escolha o modo de criação conforme o material que já tem: um pedido escrito, uma imagem inicial fixa, dois fotogramas de limite ou um clip que precisa de edição ou continuação.

O Mini tem o seu próprio perfil de saída. O fabricante indica vídeo de 480p e 720p, com cor de 8 bits, 24 fotogramas por segundo e saída MP4. As proporções suportadas são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; a duração de geração documentada é de 4–15 segundos. O controlo de duração do fabricante também permite seleção automática dentro desse intervalo. As opções de 1080p e 4K do modelo Seedance 2.0 completo são separadas; não são definições do Mini. A tabela de capacidades da família enumera a devolução do último fotograma gerado, enquanto o modo Draft não é suportado.

A referência omni cria uma cena nova usando informação selecionada dos materiais fornecidos. Uma imagem pode definir a aparência de um sujeito, a composição ou o tratamento visual. Um vídeo pode estabelecer ação, movimento de câmara ou um efeito; uma referência de áudio pode estabelecer timbre de voz, melodia ou conteúdo falado. Diga ao modelo o que deve retirar de cada referência, em vez de pedir a cópia de todas as propriedades. Por exemplo, use uma fotografia de produto para a forma e a cor, um clip curto de movimento de câmara para a aproximação e uma referência sonora para a atmosfera.

O fluxo da família permite até nove imagens de referência, três clips de vídeo e três clips de áudio. As referências de vídeo têm 2–15 segundos cada, com um máximo total de 15 segundos; as referências de áudio usam os mesmos limites por clip e de duração total. Áudio isolado e texto com áudio sem referência visual não são combinações de referências suportadas. A criação apenas com texto é um modo separado suportado. Para uma sequência, forneça os recursos na ordem pretendida e refira-os de forma consistente como Imagem 1, Vídeo 1 ou Áudio 1, usando a ordem dentro de cada tipo de conteúdo. Não substitua uma referência numerada no pedido escrito por um identificador de recurso.

Uma imagem de primeiro fotograma define a abertura de um plano orientado por imagem. O modo de primeiro e último fotogramas define ambos os limites. Se essas imagens exatas de limite forem importantes, selecione esse modo específico, em vez de descrever referências como abertura e final num pedido de referências omni. Esta última opção é um efeito orientado pelo pedido e não equivale à escolha rigorosa de fotogramas de limite. Prepare as imagens para a composição de saída e indique a ação que liga as situações inicial e final.

A edição de vídeo altera um clip existente, em vez de o usar apenas como inspiração. Identifique o vídeo a editar, o objeto ou a região a alterar, o momento e a posição em que aparece e os pormenores a preservar. Um pedido útil é: «No Vídeo 1, substitua a caneca pelo recipiente mostrado na Imagem 1; preserve o movimento da mão, o enquadramento, a iluminação e a disposição da mesa.» Para remoção, nomeie o objeto indesejado e os elementos envolventes que devem permanecer. O fabricante aconselha a referir diretamente o vídeo de destino para edição ou prolongamento; descrevê-lo como referência pode antes transmitir um pedido de geração de uma cena nova.

O prolongamento de vídeo acrescenta acontecimentos antes ou depois de um clip existente. Descreva a direção da continuação e o que acontece a seguir ou anteriormente. O fluxo documentado também pode ligar dois ou três clips com transições geradas; os três vídeos de entrada, em conjunto, continuam sujeitos ao limite de referências de 15 segundos. O tutorial distingue uma continuação que inclui sobretudo filmagens dos limites do clip original de um pedido que mantém explicitamente o conteúdo original. Indique a composição pretendida do resultado: apenas a continuação, ou uma cena que contenha o clip fornecido e a nova ação.

Para uma orientação clara, separe a descrição da cena estável da sequência de acontecimentos. Defina cada sujeito com duas ou três características visuais distintivas e uma designação consistente. Depois descreva ações, cenário, iluminação, movimento de câmara, estilo visual e restrições. Num diálogo, associe cada fala ao respetivo locutor e à ação relevante. Use designações de planos ordenadas, em vez de tratar marcas temporais exatas como controlos fiáveis: o fabricante observa que os tempos precisos podem ser instáveis. Um pedido de produto encenado pode ser: «A Imagem 1 define o Produto A. Plano 1: aproxime-se lentamente do Produto A no balcão. Plano 2: uma mão roda-o na direção da luz. Plano 3: estabilize sobre o rótulo frontal. Ambiente sonoro suave da sala; preserve as letras impressas.»

Prepare as referências de acordo com as regras de entrada documentadas para a família. Os formatos de imagem suportados incluem JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; cada imagem deve ter menos de 30 MB. O guia exige largura e altura de imagem estritamente entre 300 e 6000 píxeis e uma proporção estritamente entre 0.4 e 2.5. As referências de vídeo usam MP4 ou MOV com vídeo H.264 ou H.265 e áudio AAC ou MP3, têm no máximo 200 MB cada e 24–60 fotogramas por segundo. A largura e a altura são de 300–6000 píxeis, a proporção é de 0.4–2.5 e o número total de píxeis é de 407 696–8 295 044. As referências de áudio usam WAV ou MP3 e têm no máximo 15 MB cada. Estas são especificações de preparação de entradas do fabricante, distintas dos controlos de carregamento de uma aplicação específica.

O fluxo de retratos do fabricante exige uma preparação específica para imagens ou vídeos com rostos humanos reais: os carregamentos diretos de referências não são o percurso normalmente suportado. Documenta saídas de modelos de confiança, personagens digitais predefinidas e um fluxo autorizado de recursos de pessoas reais como soluções separadas. A correspondência de voz, a pronúncia e o som no limite de um clip também precisam de ser examinados. O guia de pedidos recomenda descrever as características de voz pretendidas e manter o estilo do diálogo próximo da referência de áudio. Reveja no artefacto final a consistência dos sujeitos, as palavras exatas pronunciadas, os tempos da ação, as transições de fotogramas e o áudio final; refine o elemento específico que diverge do pedido.

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
CampoTipoRequisitoValores e limitesPredefinição
CampomodelTipostringRequisitoObrigatórioValores e limites
bytedance/seedance-2.0-mini
Predefinição—
CampopromptTipostringRequisitoObrigatórioValores e limitesPredefinição—
CampodurationTipointegerRequisitoObrigatórioValores e limites
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Mínimo: 1
Máximo: 600
Predefinição—
CamporesolutionTipostringRequisitoOpcionalValores e limites
480p, 720p
Predefinição—
Campoaspect_ratioTipostringRequisitoOpcionalValores e limites
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Predefinição—
Campogenerate_audioTipobooleanRequisitoOpcionalValores e limites
false, true
Condições: Omitir generate_audio seleciona o preço com áudio; false seleciona o preço sem áudio. Verifique has_audio no resultado para saber se foi devolvida uma faixa de áudio.
Predefinição—
Campoframe_imagesTipoarrayRequisitoOpcionalValores 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—
Campoinput_referencesTipoarrayRequisitoOpcionalValores 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—
CamposizeTipostringRequisitoOpcionalValores e limites
480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720
Padrão: ^[1-9][0-9]*x[1-9][0-9]*$
Predefinição—
CamposeedTipointegerRequisitoOpcionalValores e limites
Mínimo: -9 223 372 036 854 775 808
Máximo: 9 223 372 036 854 775 807
Predefinição—
Campocallback_urlTipostringRequisitoOpcionalValores e limites
Padrão: ^https://
Predefinição—
Camposession_idTipostringRequisitoOpcionalValores e limitesPredefinição—
CampotraceTipoobjectRequisitoOpcionalValores e limitesPredefinição—
CampouserTipostringRequisitoOpcionalValores e limitesPredefiniçã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-mini

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-mini

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-mini

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âmetroContrato
Parâmetrocontent_typeContratoapplication/json
ParâmetrorequiredContratomodel, prompt, duration
Parâmetromaterial_typesContratotext, image, audio
Parâmetroadditional_propertiesContratofalse
Parâmetrooptional_controlsContratoresolution, 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çãoTabela de tarifasQuantidade previstaUnidade de faturaçãoCondições de faturaçãoCusto
ConfiguraçãoTarifas base por tokenTabela de tarifasTarifa baseQuantidade 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ídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor 1K tokens de vídeoCondiçõ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.007 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ídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor 1K tokens de vídeoCondições de faturaçãoentrada: with_video_inputCusto
reference · Preço por token de vídeo · Estimativa apenas para comparação $0.0042 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ídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor 1K tokens de vídeoCondições de faturaçãoáudio: without_audioCusto
Saída · Preço por token de vídeo · Estimativa apenas para comparação $0.007 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çãoTabela de tarifas—Quantidade previstaestimativa para uma geraçãoUnidade de faturação—Condições de faturação—Custo
Saída · Custo estimado de geração · Estimativa apenas para comparação $0.1512 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 →

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çãoCondições de faturaçãoCusto
ConfiguraçãoPreço por token de vídeoCondiçõ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.007 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ídeoCondições de faturaçãoáudio: without_audioCusto
Saída · Preço por token de vídeo $0.007 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ídeoCondições de faturaçãoentrada: with_video_inputCusto
reference · Preço por token de vídeo $0.0042 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

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

Receber e guardar os resultados

Ailoot Ultra · Vídeo

URLs assinados para conteúdo pertencente ao utilizador

Verificar o estado da tarefa
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Outras leituras de conteúdo
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
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
CampoTipoSignificado
CampoindexTipointegerSignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero.
Campocontent_urlTipostringSignificadoURL HTTPS assinado para transferir este vídeo concluído.
Camposha256Tipostring | nullSignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível.
Camposize_bytesTipointeger | nullSignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível.
Campoduration_msTipointeger | nullSignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível.
CampowidthTipointeger | nullSignificadoLargura do vídeo em píxeis; null se não estiver disponível.
CampoheightTipointeger | nullSignificadoAltura do vídeo em píxeis; null se não estiver disponível.
Campovideo_codecTipostring | nullSignificadoIdentificador do codec de vídeo; null se não estiver registado.
Campohas_audioTipoboolean | nullSignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido.
Campoaudio_codecTipostring | nullSignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador.
Erros e passos seguintes
RespostaCondiçãoPasso seguinte
Resposta404 · not_found_errorCondiçã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_errorCondiçãoA chave API não corresponde à conta autenticada.Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar.
Resposta400 · invalid_request_errorCondiçã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_unavailableCondiçã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_errorCondiçã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_errorCondiçã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_errorCondiçã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_checkCondiçã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_unavailableCondiçã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_readyCondiçã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-mini

Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

IDs de chamada relacionados

bytedance/seedance-2.0-mini

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-mini", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-mini", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "O acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Verifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API.", "type": "not_found_error" }, { "condition": "A chave API não corresponde à conta autenticada.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Verifique a sua chave API e o acesso à conta antes de enviar.", "type": "authentication_error" }, { "condition": "Não foi possível ler o pedido ou o índice de transferência é inválido.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original.", "type": "invalid_request_error" }, { "condition": "Não é possível calcular o preço da configuração de vídeo selecionada.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Escolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido.", "type": "price_unavailable" }, { "condition": "Uma entrada de vídeo ou a tarefa original de continuação é inválida.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API.", "type": "invalid_request_error" }, { "condition": "O saldo disponível ou os limites não permitem efetuar uma reserva.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Verifique o saldo disponível e os limites antes de enviar um novo pedido.", "type": "billing_error" }, { "condition": "A verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Aguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração.", "type": "server_error" }, { "code": "result_pending_check", "condition": "O resultado e a cobrança do vídeo original precisam de verificação.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "A transferência do vídeo existente está temporariamente indisponível.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Consulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada.", "type": "server_error" }, { "condition": "O conteúdo do vídeo não foi publicado.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Consulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id original + X-Should-Retry:false; nunca repita o original" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration" ], "required_material": "Uma instrução escrita." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Uma instrução escrita e uma imagem de fotograma." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Uma instrução escrita e referências de imagem ou áudio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posição deste vídeo na lista de saídas, com contagem a partir de zero.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS assinado para transferir este vídeo concluído.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Resumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Tamanho do ficheiro de vídeo original em bytes; null se não estiver disponível.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Duração medida do vídeo em milissegundos; null se não estiver disponível.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Largura do vídeo em píxeis; null se não estiver disponível.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Altura do vídeo em píxeis; null se não estiver disponível.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificador do codec de vídeo; null se não estiver registado.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indica se o vídeo contém uma faixa de áudio; null se não tiver sido medido.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificador do codec de áudio; null quando não está registado qualquer identificador.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URLs assinados para conteúdo pertencente ao utilizador", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-mini" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Omitir generate_audio seleciona o preço com áudio; false seleciona o preço sem áudio. Verifique has_audio no resultado para saber se foi devolvida uma faixa de áudio.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Estas chaves aplicam-se a cada objeto de fotograma. Omita frame_images num pedido apenas de texto.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Omita frame_images para utilizar o modo de referência. Utilize URLs HTTPS públicos.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-mini" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "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.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "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.", "dimensions": { "conditions": "entrada: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Custo estimado de geração", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-mini\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "bytedance/seedance-2.0-mini", "nativeProvenance": { "input_facts_canonical_sha256": "50d61fc1a640e3f4979939e895866ec7893d9af508cec269b769ab5aa205bcb5", "input_html_sha256": "c18602ba99b5ca57759056c5e94a95973944dfb7d08182cdd0d68c71a46a8326", "private_audit_sha256": "e8b246f3637448dc2e4df6e1b52b2263f66abb8d97247dad1c37339fd295fdee", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0-mini/", "description": "O Seedance 2.0 Mini cria vídeos curtos com som gerado opcional a partir de texto e referências de imagem, vídeo e áudio. Suporta criação de cenas, edições direcionadas de vídeo e continuação, com um perfil de saída documentado de 480p ou 720p.", "locale": "pt-pt", "md_url": "https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0-mini/index.md", "title": "ByteDance: Seedance 2.0 Mini — Ailoot", "url": "https://ailoot.ai/models/pt-pt/bytedance-seedance-2-0-mini/" }, "rawModel": { "about": "O Seedance 2.0 Mini é um modelo com designação própria na família audiovisual Seedance 2.0 da ByteDance. O fabricante documenta texto para vídeo, imagem para vídeo com primeiro fotograma ou com primeiro e último fotogramas, geração com referências multimodais, edição de vídeo e prolongamento de vídeo. O som pode ser gerado em conjunto com a imagem. Escolha o modo de criação conforme o material que já tem: um pedido escrito, uma imagem inicial fixa, dois fotogramas de limite ou um clip que precisa de edição ou continuação.\n\nO Mini tem o seu próprio perfil de saída. O fabricante indica vídeo de 480p e 720p, com cor de 8 bits, 24 fotogramas por segundo e saída MP4. As proporções suportadas são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; a duração de geração documentada é de 4–15 segundos. O controlo de duração do fabricante também permite seleção automática dentro desse intervalo. As opções de 1080p e 4K do modelo Seedance 2.0 completo são separadas; não são definições do Mini. A tabela de capacidades da família enumera a devolução do último fotograma gerado, enquanto o modo Draft não é suportado.\n\nA referência omni cria uma cena nova usando informação selecionada dos materiais fornecidos. Uma imagem pode definir a aparência de um sujeito, a composição ou o tratamento visual. Um vídeo pode estabelecer ação, movimento de câmara ou um efeito; uma referência de áudio pode estabelecer timbre de voz, melodia ou conteúdo falado. Diga ao modelo o que deve retirar de cada referência, em vez de pedir a cópia de todas as propriedades. Por exemplo, use uma fotografia de produto para a forma e a cor, um clip curto de movimento de câmara para a aproximação e uma referência sonora para a atmosfera.\n\nO fluxo da família permite até nove imagens de referência, três clips de vídeo e três clips de áudio. As referências de vídeo têm 2–15 segundos cada, com um máximo total de 15 segundos; as referências de áudio usam os mesmos limites por clip e de duração total. Áudio isolado e texto com áudio sem referência visual não são combinações de referências suportadas. A criação apenas com texto é um modo separado suportado. Para uma sequência, forneça os recursos na ordem pretendida e refira-os de forma consistente como Imagem 1, Vídeo 1 ou Áudio 1, usando a ordem dentro de cada tipo de conteúdo. Não substitua uma referência numerada no pedido escrito por um identificador de recurso.\n\nUma imagem de primeiro fotograma define a abertura de um plano orientado por imagem. O modo de primeiro e último fotogramas define ambos os limites. Se essas imagens exatas de limite forem importantes, selecione esse modo específico, em vez de descrever referências como abertura e final num pedido de referências omni. Esta última opção é um efeito orientado pelo pedido e não equivale à escolha rigorosa de fotogramas de limite. Prepare as imagens para a composição de saída e indique a ação que liga as situações inicial e final.\n\nA edição de vídeo altera um clip existente, em vez de o usar apenas como inspiração. Identifique o vídeo a editar, o objeto ou a região a alterar, o momento e a posição em que aparece e os pormenores a preservar. Um pedido útil é: «No Vídeo 1, substitua a caneca pelo recipiente mostrado na Imagem 1; preserve o movimento da mão, o enquadramento, a iluminação e a disposição da mesa.» Para remoção, nomeie o objeto indesejado e os elementos envolventes que devem permanecer. O fabricante aconselha a referir diretamente o vídeo de destino para edição ou prolongamento; descrevê-lo como referência pode antes transmitir um pedido de geração de uma cena nova.\n\nO prolongamento de vídeo acrescenta acontecimentos antes ou depois de um clip existente. Descreva a direção da continuação e o que acontece a seguir ou anteriormente. O fluxo documentado também pode ligar dois ou três clips com transições geradas; os três vídeos de entrada, em conjunto, continuam sujeitos ao limite de referências de 15 segundos. O tutorial distingue uma continuação que inclui sobretudo filmagens dos limites do clip original de um pedido que mantém explicitamente o conteúdo original. Indique a composição pretendida do resultado: apenas a continuação, ou uma cena que contenha o clip fornecido e a nova ação.\n\nPara uma orientação clara, separe a descrição da cena estável da sequência de acontecimentos. Defina cada sujeito com duas ou três características visuais distintivas e uma designação consistente. Depois descreva ações, cenário, iluminação, movimento de câmara, estilo visual e restrições. Num diálogo, associe cada fala ao respetivo locutor e à ação relevante. Use designações de planos ordenadas, em vez de tratar marcas temporais exatas como controlos fiáveis: o fabricante observa que os tempos precisos podem ser instáveis. Um pedido de produto encenado pode ser: «A Imagem 1 define o Produto A. Plano 1: aproxime-se lentamente do Produto A no balcão. Plano 2: uma mão roda-o na direção da luz. Plano 3: estabilize sobre o rótulo frontal. Ambiente sonoro suave da sala; preserve as letras impressas.»\n\nPrepare as referências de acordo com as regras de entrada documentadas para a família. Os formatos de imagem suportados incluem JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; cada imagem deve ter menos de 30 MB. O guia exige largura e altura de imagem estritamente entre 300 e 6000 píxeis e uma proporção estritamente entre 0.4 e 2.5. As referências de vídeo usam MP4 ou MOV com vídeo H.264 ou H.265 e áudio AAC ou MP3, têm no máximo 200 MB cada e 24–60 fotogramas por segundo. A largura e a altura são de 300–6000 píxeis, a proporção é de 0.4–2.5 e o número total de píxeis é de 407 696–8 295 044. As referências de áudio usam WAV ou MP3 e têm no máximo 15 MB cada. Estas são especificações de preparação de entradas do fabricante, distintas dos controlos de carregamento de uma aplicação específica.\n\nO fluxo de retratos do fabricante exige uma preparação específica para imagens ou vídeos com rostos humanos reais: os carregamentos diretos de referências não são o percurso normalmente suportado. Documenta saídas de modelos de confiança, personagens digitais predefinidas e um fluxo autorizado de recursos de pessoas reais como soluções separadas. A correspondência de voz, a pronúncia e o som no limite de um clip também precisam de ser examinados. O guia de pedidos recomenda descrever as características de voz pretendidas e manter o estilo do diálogo próximo da referência de áudio. Reveja no artefacto final a consistência dos sujeitos, as palavras exatas pronunciadas, os tempos da ação, as transições de fotogramas e o áudio final; refine o elemento específico que diverge do pedido.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-mini", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Todas as tarifas da configuração constam dos detalhes." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "0b52dda4bb8d8eb2776e0f56", "label": "Referências de preços das configurações de vídeo", "profiles": [ { "basis": "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.", "dimensions": { "conditions": "Não é declarada nenhuma condição adicional nesta chave de preços." }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.007", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "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.", "dimensions": { "conditions": "áudio: without_audio" }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.007", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "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.", "dimensions": { "conditions": "entrada: with_video_input" }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.0042", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0-mini", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "O acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Verifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API.", "type": "not_found_error" }, { "condition": "A chave API não corresponde à conta autenticada.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Verifique a sua chave API e o acesso à conta antes de enviar.", "type": "authentication_error" }, { "condition": "Não foi possível ler o pedido ou o índice de transferência é inválido.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original.", "type": "invalid_request_error" }, { "condition": "Não é possível calcular o preço da configuração de vídeo selecionada.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Escolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido.", "type": "price_unavailable" }, { "condition": "Uma entrada de vídeo ou a tarefa original de continuação é inválida.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API.", "type": "invalid_request_error" }, { "condition": "O saldo disponível ou os limites não permitem efetuar uma reserva.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Verifique o saldo disponível e os limites antes de enviar um novo pedido.", "type": "billing_error" }, { "condition": "A verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Aguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração.", "type": "server_error" }, { "code": "result_pending_check", "condition": "O resultado e a cobrança do vídeo original precisam de verificação.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "A transferência do vídeo existente está temporariamente indisponível.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Consulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada.", "type": "server_error" }, { "condition": "O conteúdo do vídeo não foi publicado.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Consulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id original + X-Should-Retry:false; nunca repita o original" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration" ], "required_material": "Uma instrução escrita." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Uma instrução escrita e uma imagem de fotograma." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Uma instrução escrita e referências de imagem ou áudio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posição deste vídeo na lista de saídas, com contagem a partir de zero.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS assinado para transferir este vídeo concluído.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Resumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Tamanho do ficheiro de vídeo original em bytes; null se não estiver disponível.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Duração medida do vídeo em milissegundos; null se não estiver disponível.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Largura do vídeo em píxeis; null se não estiver disponível.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Altura do vídeo em píxeis; null se não estiver disponível.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificador do codec de vídeo; null se não estiver registado.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indica se o vídeo contém uma faixa de áudio; null se não tiver sido medido.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificador do codec de áudio; null quando não está registado qualquer identificador.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URLs assinados para conteúdo pertencente ao utilizador", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-mini" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Omitir generate_audio seleciona o preço com áudio; false seleciona o preço sem áudio. Verifique has_audio no resultado para saber se foi devolvida uma faixa de áudio.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Estas chaves aplicam-se a cada objeto de fotograma. Omita frame_images num pedido apenas de texto.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Omita frame_images para utilizar o modo de referência. Utilize URLs HTTPS públicos.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-mini" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "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.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "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.", "dimensions": { "conditions": "entrada: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Preço por token de vídeo", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Custo estimado de geração", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-mini\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "bytedance/seedance-2.0-mini", "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Mini", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.1512, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.1512, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000070", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000042", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.0070000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000070", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000070", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0070000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000070", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000070", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.0000042", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-mini", "short": "O Seedance 2.0 Mini cria vídeos curtos com som gerado opcional a partir de texto e referências de imagem, vídeo e áudio. Suporta criação de cenas, edições direcionadas de vídeo e continuação, com um perfil de saída documentado de 480p ou 720p." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "O Seedance 2.0 Mini cria vídeos curtos com som gerado opcional a partir de texto e referências de imagem, vídeo e áudio. Suporta criação de cenas, edições direcionadas de vídeo e continuação, com um perfil de saída documentado de 480p ou 720p.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "c1f32138f3b46f81b300801ad519fee8aeedd94bd3fadc02560dd80e7bb0fc5c", "raw_model_js_projection_sha256": "6e941f7df54995c333afa09d288ddf5aa12f75ea59363b8a07bc1c9efa1d6003", "raw_model_json_sha256": "c1f32138f3b46f81b300801ad519fee8aeedd94bd3fadc02560dd80e7bb0fc5c", "renderer_sha256": "8caea4544177cc2b7d2cb3356b5f07bfd3660386d75f2714a6f603fa5e2a6cd2" }, "sourceRevision": "2830a270fd8ba19a26cce26b2d025a4274338e00a1835dbb21e142e89646611c" }