ByteDance: Seedance 2.0
O ByteDance Seedance 2.0 combina geração audiovisual nativa com referências de imagem, vídeo e som. Dirija novas cenas, edite filmagens existentes ou prolongue uma sequência; a edição standard inclui saída documentada de 1080p e 4K de 10 bits.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
O Seedance 2.0 é o modelo standard da ByteDance Seed para criação audiovisual multimodal. Combina texto, imagens, vídeos e áudio numa arquitetura de geração conjunta, com fluxos criativos separados para cenas orientadas por referências, edição de vídeo e prolongamento de vídeo. É útil quando o pedido precisa de uma interpretação coerente e de informação visual ou sonora específica de materiais preparados.
Referências multimodais e controlo de realização
As imagens podem definir a aparência do sujeito, o estilo visual e a composição. As referências de vídeo podem orientar ação, movimento de câmara e efeitos. O áudio pode orientar timbre de voz, música ou diálogo. Defina a função de cada material e depois descreva a cena que deve resultar. O fabricante destaca o controlo da interpretação, da iluminação, das sombras e da linguagem de câmara.
Para uma história de produto, prepare uma imagem do produto, uma referência de movimento de câmara e uma indicação sonora. Um pedido pode ser: «Preserve a jarra de vidro azul da Imagem 1. Use o movimento lateral lento de travelling do Vídeo 1. A jarra está numa prateleira ao sol, com música instrumental suave baseada no Áudio 1.» A saída pretendida é uma cena encenada de novo que combina informação selecionada das referências.
As entradas de referência podem combinar imagem e áudio, imagem e vídeo, vídeo e áudio, ou os três. Entrada apenas de áudio e texto com áudio sem imagem ou vídeo não são suportados. Também estão documentados texto para vídeo tradicional, geração com primeiro fotograma e geração com primeiro e último fotogramas. Se forem importantes composições fixas na abertura e no fecho, use o fluxo específico de pontos extremos: nomear uma imagem de referência como ponto extremo num pedido de referências omni é apenas uma forma indireta de o orientar.
Edição de filmagens
O modelo pode substituir um sujeito, acrescentar ou remover objetos, alterar elementos e redesenhar ou reparar partes de um vídeo. Descreva a alteração específica e identifique as filmagens de origem. Para uma adição, inclua o momento e a posição de aparecimento; para uma remoção ou substituição, indique o objeto com precisão e nomeie o que deve permanecer.
Por exemplo: «Substitua o candeeiro de secretária do Vídeo 1 pelo candeeiro de latão da Imagem 1. Mantenha o movimento da câmara, a disposição da secretária e a direção da iluminação.» O resultado pretendido é uma versão editada da cena com a substituição prevista. Examine as áreas inalteradas e o novo objeto, sobretudo durante ocultações, movimentos e mudanças de plano.
Prolongamento e ligação de uma sequência
O Seedance 2.0 pode prolongar um vídeo para a frente ou para trás e ligar até três clips fornecidos com transições geradas. Especifique a direção temporal e o novo acontecimento. Para uma ligação, ordene os clips e descreva a transição entre cada par, como uma câmara que entra por uma porta num plano e chega ao ambiente seguinte.
Um prolongamento simples devolve normalmente a continuação desenvolvida em torno das filmagens de origem; inclua uma instrução clara se o resultado final também deve repetir o segmento original. Ao completar uma ligação entre dois ou três clips, o fluxo documentado pode incluir tanto material original como novo conteúdo de transição. Isto é útil para desenvolver uma abertura ou um final, ou ligar cenas preparadas sem deixar a ação de ligação por especificar.
Saída da edição standard e 4K
A edição standard documenta MP4 a 24 fps e durações de 4 a 15 segundos. Os níveis de saída são 480p, 720p e 1080p com profundidade de cor de 8 bits, mais 4K com profundidade de cor de 10 bits. As proporções suportadas são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16. Também estão documentados enquadramento adaptativo e seleção automática da duração. A edição Fast tem a sua própria especificação de saída mais restrita, de 480p/720p.
A saída 4K usa codificação H.265/HEVC. A codificação de dez bits preserva gradações tonais adicionais e transições de cor mais suaves, o que é relevante para material com gradientes subtis de luz ou cor. Verifique se o ambiente de reprodução e edição pretendido consegue descodificar esse formato; alguns navegadores e dispositivos não o reproduzem diretamente. Um contentor compatível não garante, por si só, descodificação de vídeo compatível.
O modelo pode gerar som sincronizado ou vídeo silencioso e devolver o último fotograma gerado para uma cena posterior. O áudio gerado é mono. A família 2.0 não suporta o modo separado de pré-visualização Draft em duas etapas, pelo que essa funcionalidade não deve ser inferida a partir de outra edição Seedance.
Preparação de referências e limites relevantes
A capacidade de referências documentada é de até nove imagens, três vídeos e três clips de áudio. Este perfil documentado do fabricante não aceita carregamentos diretos de imagens ou vídeos de referência com rostos humanos reais; os retratos usam o fluxo de recursos de retrato suportado. Cada clip de vídeo e áudio deve durar 2–15 segundos. Todas as referências de vídeo, juntas, devem caber em 15 segundos, e todas as referências de áudio têm o seu próprio total de 15 segundos. Os ficheiros de vídeo usam MP4 ou MOV a 24–60 fps, até 200 MB cada; os ficheiros de áudio usam WAV ou MP3, até 15 MB cada. Os formatos de imagem enumerados são JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF. As imagens devem ter menos de 30 MB cada e o corpo do pedido não deve exceder 64 MB. No perfil de entrada de referências documentado, a largura e a altura das imagens devem estar ambas estritamente entre 300 e 6000 píxeis, com uma proporção largura/altura estritamente entre 0.4 e 2.5. Os vídeos de referência permitem 300–6000 píxeis em cada dimensão e proporções de 0.4–2.5, inclusive, com 407 696–8 295 044 píxeis no total. Os vídeos MP4 ou MOV usam vídeo H.264/AVC ou H.265/HEVC e áudio AAC ou MP3.
Ordene os ficheiros intencionalmente e refira cada um pelo tipo de conteúdo e número: Imagem 1, Vídeo 1 e Áudio 1. O número segue a ordem entre ficheiros desse tipo. Explique que características transferir e que conteúdo de origem não deve definir a nova cena. Os idiomas documentados para pedidos incluem inglês, espanhol, indonésio, português e japonês. Mantenha o idioma falado consistente dentro de um diálogo; o guia desaconselha misturar idiomas, exceto em nomes próprios. Para trabalho orientado por voz, separe o locutor, a fala exata e a indicação de interpretação.
Prepare a primeira e a última imagens com enquadramento compatível. Uma divergência entre a imagem de entrada e as dimensões de saída pode provocar um recorte ou uma mudança visual abrupta; dimensões coincidentes e enquadramento adaptativo são soluções documentadas. Concentre a descrição no acontecimento e nas funções das referências. O fabricante alerta que pedidos longos podem dispersar a informação, levando a ignorar pormenores. Reveja o movimento resultante, a continuidade das referências, a interpretação áudio e as junções entre cenas como partes distintas do resultado criativo.
Planeamento de planos e orientação do texto
Para uma cena complexa, organize o pedido em Plano 1, Plano 2 e Plano 3, especificando por ordem a câmara, a ação do sujeito, a posição e o som. O guia recomenda um movimento de câmara por plano e dar prioridade a ações lentas e ligadas. As marcas temporais precisas por plano são instáveis, pelo que uma sequência de acontecimentos é um controlo melhor do que impor várias janelas temporais exatas.
O modelo também gera texto comum, incluindo slogans, legendas e balões de fala. Pode orientar a cor, o tratamento visual, a localização e a entrada do texto. Use caracteres comuns em vez de caracteres raros ou símbolos especiais e reveja a formulação em movimento. Para referências de sujeitos, associe claramente cada recurso à personagem ou objeto pretendido. Diferentes vistas de produto podem fornecer informação visual diferente; colagens de vistas de personagem podem confundir a identidade facial. A recomendação documentada para referência de personagem é uma imagem de rosto clara e uma de corpo inteiro, separadas.
Comportamentos a examinar antes de uma edição
O guia documenta legendas indesejadas, logótipos, personagens duplicadas e desvios de estilo. Materiais de origem limpos, designações consistentes e restrições explícitas reduzem esses riscos, mas não garantem que o texto indesejado ou as figuras duplicadas desapareçam. Mais de quatro pessoas de referência é um risco de estabilidade assinalado, distinto do número de ficheiros que o modelo aceita.
O prolongamento de vídeo pode criar um salto ou recuo na junção e continuações repetidas podem acumular degradação da qualidade da imagem. Examine os fotogramas dos limites e limite a acumulação de prolongamentos sucessivos. Uma voz de referência pode diferir do timbre de origem; a narração pode terminar com um clique ou um corte abrupto, para o qual um desvanecimento do áudio é uma solução documentada. Caracteres chineses polifónicos, pouco comuns ou de forma semelhante podem ser pronunciados incorretamente. Para um efeito animado preciso, como uma contagem decrescente, uma referência de movimento é mais informativa do que um pedido apenas verbal. Estas são razões concretas para verificar separadamente identidade, texto, movimento e som ao selecionar o clip.
Ailoot Ultra · Vídeo POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Introdução
O ByteDance Seedance 2.0 combina geração audiovisual nativa com referências de imagem, vídeo e som. Dirija novas cenas, edite filmagens existentes ou prolongue uma sequência; a edição standard inclui saída documentada de 1080p e 4K de 10 bits.
- Entradas aceites
- Texto · Imagens · Áudio
- Resultados
- Vídeo
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Entrada
text,image,audio- Saída
video- Formato de saída
- bytes MP4 originais; sem normalização nem transcodificação
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites bytedance/seedance-2.0 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campoduration | Tipointeger | RequisitoObrigatório | Valores e limites 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 480p, 720p, 1080p, 4K | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Predefinição— |
Campogenerate_audio | Tipoboolean | RequisitoOpcional | Valores e limites false, true Condições: Em 480p e 720p, omitir generate_audio seleciona o preço com áudio e false seleciona o preço sem áudio. Em 1080p e 4K, o preço da resolução aplica-se a ambas as definições. Verifique has_audio no resultado para identificar a faixa de áudio devolvida. | Predefinição— |
Campoframe_images | Tipoarray | RequisitoOpcional | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 2 Conteúdo de entrada: Matriz de objetos de fotograma. Cada um tem type=image_url, image_url com url e frame_type=first_frame ou last_frame. Cada função aparece, no máximo, uma vez. Utilize URLs HTTPS públicos. Chaves exatas: type, image_url, frame_type Condições: Estas chaves aplicam-se a cada objeto de fotograma. Omita frame_images num pedido apenas de texto. | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites Conteúdo de entrada: Matriz de objetos de referência de imagem ou áudio. Defina type como image_url ou audio_url e forneça o objeto URL correspondente com url. Continua a não ser possível calcular o preço de referências de vídeo. Condições: Omita frame_images para utilizar o modo de referência. Utilize URLs HTTPS públicos. | Predefinição— |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Padrão: ^[1-9][0-9]*x[1-9][0-9]*$ | Predefinição— |
Camposeed | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: -9 223 372 036 854 775 808 Máximo: 9 223 372 036 854 775 807 | Predefinição— |
Campocallback_url | Tipostring | RequisitoOpcional | Valores e limites Padrão: ^https:// | Predefinição— |
Camposession_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campotrace | Tipoobject | RequisitoOpcional | Valores e limites | Predefinição— |
Campouser | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Combinações de materiais de entrada
Texto para vídeo · Uma instrução escrita. · Obrigatório: model, prompt, duration
Forneça uma instrução de texto e uma duração suportada em segundos inteiros. Utilize um tamanho exato enumerado ou uma resolução e uma proporção que correspondam a dimensões enumeradas.
model: Tipo: string · bytedance/seedance-2.0
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Imagem para vídeo · Uma instrução escrita e uma imagem de fotograma. · Obrigatório: model, prompt, duration, frame_images
frame_images é uma matriz de objetos com type=image_url, image_url com url e frame_type. Utilize um URL HTTPS público de imagem; first_frame e last_frame podem aparecer uma vez cada. Utilize um tamanho de saída enumerado ou dimensões compatíveis. Não adicione referências de vídeo.
Chaves exatas: type, image_url, frame_type
model: Tipo: string · bytedance/seedance-2.0
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Reference to video · Uma instrução escrita e referências de imagem ou áudio. · Obrigatório: model, prompt, duration, input_references
input_references é uma matriz. Cada objeto tem type=image_url ou type=audio_url e um objeto URL correspondente com url. Utilize ligações HTTPS públicas. Omita frame_images para selecionar o modo de referência. Não é possível calcular o preço de referências de vídeo.
model: Tipo: string · bytedance/seedance-2.0
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, duration |
Parâmetromaterial_types | Contratotext, image, audio |
Parâmetroadditional_properties | Contratofalse |
Parâmetrooptional_controls | Contratoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Condições de faturação | Custo |
|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Condições de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação $0.014 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoresolution: 1080p | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação $0.0154 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoentrada: with_video_input; resolução: 1080p | Custo reference · Preço por token de vídeo · Estimativa apenas para comparação $0.0094 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoresolution: 4k | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação $0.008 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoentrada: with_video_input; resolução: 4k | Custo reference · Preço por token de vídeo · Estimativa apenas para comparação $0.0048 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoentrada: with_video_input | Custo reference · Preço por token de vídeo · Estimativa apenas para comparação $0.0086 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor 1K tokens de vídeo | Condições de faturaçãoáudio: without_audio | Custo Saída · Preço por token de vídeo · Estimativa apenas para comparação $0.014 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.3024 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Detalhes da tarifa de referência
As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.
Referências de preços das configurações de vídeo
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço por token de vídeo $0.014 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoresolution: 4k | Custo Saída · Preço por token de vídeo $0.008 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoresolution: 1080p | Custo Saída · Preço por token de vídeo $0.0154 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoáudio: without_audio | Custo Saída · Preço por token de vídeo $0.014 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoentrada: with_video_input | Custo reference · Preço por token de vídeo $0.0086 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoentrada: with_video_input; resolução: 4k | Custo reference · Preço por token de vídeo $0.0048 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
| ConfiguraçãoPreço por token de vídeo | Condições de faturaçãoentrada: with_video_input; resolução: 1080p | Custo reference · Preço por token de vídeo $0.0094 por 1K tokens de vídeo A tarifa por token de vídeo é a principal referência de preço. As estimativas em destaque por segundo são referências separadas e não constituem um encargo adicional. |
Exemplos de pedidos
Ailoot Ultra · Vídeo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Receber e guardar os resultados
Ailoot Ultra · Vídeo
URLs assinados para conteúdo pertencente ao utilizador
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Verificar o estado da tarefa
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Outras leituras de conteúdo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Guardar todos os resultados concluídos
Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.
Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.
Se for necessário verificar a resposta original
503 result_pending_check + id original + X-Should-Retry:false; nunca repita o original
Campos da resposta
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS assinado para transferir este vídeo concluído. |
Camposha256 | Tipostring | null | SignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível. |
Camposize_bytes | Tipointeger | null | SignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível. |
Campoduration_ms | Tipointeger | null | SignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível. |
Campowidth | Tipointeger | null | SignificadoLargura do vídeo em píxeis; null se não estiver disponível. |
Campoheight | Tipointeger | null | SignificadoAltura do vídeo em píxeis; null se não estiver disponível. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador do codec de vídeo; null se não estiver registado. |
Campohas_audio | Tipoboolean | null | SignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador. |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta404 · not_found_error | CondiçãoO acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado. | Passo seguinteVerifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API. |
Resposta401 · authentication_error | CondiçãoA chave API não corresponde à conta autenticada. | Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar. |
Resposta400 · invalid_request_error | CondiçãoNão foi possível ler o pedido ou o índice de transferência é inválido. | Passo seguinteCorrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original. |
Resposta422 · price_unavailable | CondiçãoNão é possível calcular o preço da configuração de vídeo selecionada. | Passo seguinteEscolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido. |
Resposta422 · invalid_request_error | CondiçãoUma entrada de vídeo ou a tarefa original de continuação é inválida. | Passo seguinteUtilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API. |
Resposta402 · billing_error | CondiçãoO saldo disponível ou os limites não permitem efetuar uma reserva. | Passo seguinteVerifique o saldo disponível e os limites antes de enviar um novo pedido. |
Resposta503 · server_error | CondiçãoA verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível. | Passo seguinteAguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração. |
Resposta503 · result_pending_check | CondiçãoO resultado e a cobrança do vídeo original precisam de verificação. | Passo seguinteConserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada. |
Resposta503 · owned_result_unavailable | CondiçãoA transferência do vídeo existente está temporariamente indisponível. | Passo seguinteConsulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada. |
Resposta409 · video_not_ready | CondiçãoO conteúdo do vídeo não foi publicado. | Passo seguinteConsulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança. |
Aliases
Aliases do modelo
Ailoot Ultra bytedance/seedance-2.0
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · ByteDance: Seedance 2.0
- Que entradas e resultados estão disponíveis?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Que campos utiliza o pedido?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Que limites se aplicam?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807