modelos

Alibaba: Wan 3.0

Markdown · JSON

Alibaba: Wan 3.0

Alibaba Wan 3.0 cria vídeo com som a partir de uma instrução, do primeiro fotograma ou do primeiro/último fotograma e de referências multimodais. O seu perfil do fabricante combina storyboards, edição baseada numa fonte e continuação num só modelo, com saída MP4 de 2–30 segundos a 30 fps e resolução de 480p, 720p ou 1080p.

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.

Alibaba Wan 3.0 é um perfil integrado de criação de vídeo concebido para transformar instruções e material de apoio numa cena com o seu som. O fabricante identifica o modelo Standard como wan3.0-video. A geração apenas em texto, os fotogramas inicial e final, as referências multimodais, a edição e a continuação utilizam configurações de entrada diferentes dentro desse perfil. Os recursos úteis incluem uma narrativa curta, uma apresentação de produto, uma transição baseada em imagem ou um clipe de origem revisto cujas alterações seguem uma direção criativa específica.

Para uma cena apenas em texto, prepare o sujeito, o local, a ação, a câmara, o estilo visual e o som. O fabricante suporta planos únicos e storyboards de vários planos, com uma estrutura recomendada de cerca de quatro a seis segundos por plano e intervalos de tempo opcionais. Numa história curta, apresente um pequeno pássaro mecânico numa bancada, acompanhe o seu primeiro movimento e termine num grande plano mantido enquanto o som ambiente da sala continua. Descreva a relação visual entre esses momentos, para que um limite de trinta segundos sirva uma história coerente em vez de uma lista de ações desligadas.

A geração a partir do primeiro fotograma anima uma imagem fixa fornecida. A imagem define a composição inicial, enquanto a instrução explica o movimento e o trabalho de câmara. A geração com primeiro/último fotograma fixa também o fim e descreve a transição entre as duas imagens. Prepare extremos com uma cena compatível e o enquadramento pretendido. O guia recomenda seleção adaptativa de proporção para estes modos. As suas entradas de fotogramas mantêm-se separadas das configurações de imagem de referência, vídeo de referência, áudio de referência, ficheiro e ligação Web, pelo que deve selecionar o modo de material correspondente ao plano previsto.

O modo de referências combina até dez imagens, cinco clipes de vídeo e cinco clipes de áudio, dentro de um limite total de vinte materiais. As referências de imagem podem identificar uma personagem, um objeto, um cenário ou um estilo; o vídeo pode orientar o movimento ou o trabalho de câmara e o áudio pode orientar a interpretação ou o ritmo. Rótulos específicos do tipo, como Image 1, Video 1 e Audio 1, seguem a ordem de entrada de forma independente. Dê um papel a cada referência e descreva como deve interagir com as restantes. Uma personagem com o aspeto correto no cenário errado é uma falha diferente de uma câmara que não capta o movimento pretendido.

Os limites documentados dos ficheiros de referência são 20 MB por imagem, 100 MB por vídeo e 15 MB por clipe de áudio. Os vídeos de referência estão limitados, em conjunto, a quinze segundos, e as referências de áudio têm um limite combinado separado de quinze segundos. Um documento ou uma referência a uma página Web pública podem acompanhar o material de referência; um documento e uma ligação são mutuamente exclusivos. A fonte tem de estar publicamente acessível sem início de sessão. Prepare uma fonte focada e indique que conteúdo deve informar o clipe, sobretudo quando um documento contém mais informação do que a cena consegue utilizar.

O áudio nativo combina diálogo, música de fundo, ambiente e efeitos sonoros com a imagem gerada. Indique as palavras a dizer, quem as diz e a interpretação, os efeitos importantes e se deve existir música de fundo. O áudio está ativado por predefinição no guia do fabricante e pode ser desativado. Numa cena de demonstração, uma frase introdutória curta pode anteceder um pormenor de produto enquanto um som mecânico discreto marca o movimento. Ouça o clipe concluído quanto à redação efetiva, à atribuição e à sincronização, em vez de avaliar o áudio apenas a partir das instruções escritas.

Numa edição, descreva a alteração e o conteúdo conservado. O guia abrange acrescentar ou remover elementos, substituir atributos, mudar o estilo visual ou a iluminação e rever o diálogo. Para continuação, descreva o que deve ocorrer antes, depois ou à volta do clipe existente. O enquadramento adaptativo e a duração inteligente ajudam o fluxo com vídeo de origem a preservar o seu formato e a intenção temporal. Quando é fornecida uma entrada de vídeo, a duração combinada documentada do vídeo de entrada e de saída não pode exceder 30 segundos. Conserve a fonte original e inspecione a região alterada, bem como a continuidade ao longo de todo o clipe.

A saída é MP4 a 30 fps, com resolução de 480p, 720p ou 1080p. As durações de nova geração vão de dois a trinta segundos, ou uma definição de duração inteligente pode deixar o modelo escolher a duração. Estão documentados formatos horizontal, quadrado e vertical, com enquadramento adaptativo adequado ao material fornecido. O fabricante processa o pedido como uma tarefa e devolve uma localização de vídeo concluído válida durante vinte e quatro horas. Guarde o resultado efetivo, as instruções e as referências como registo de produção e verifique a duração e o enquadramento devolvidos antes de o organizar com outros clipes.

Wan 3.0 Standard e a sua variante Prime partilham os modos integrados documentados; Prime dá ênfase à velocidade de geração. Wan 2.7 e 2.6 têm regras distintas de duração e referências por tarefa, pelo que as suas interfaces não devem ser tratadas como a configuração desta edição. Reveja a cena concluída quanto à identidade de personagens e produtos, continuidade espacial, fala, efeitos, pormenores derivados das fontes e início e fim pretendidos. Uma correção seguinte específica preserva a direção bem-sucedida enquanto resolve o defeito efetivo encontrado no clipe.

Ailoot Ultra · Vídeo POST /v1/videos alibaba/wan-3.0

alibaba/wan-3.0

Alibaba /alibaba/wan-3.0

Introdução

Alibaba Wan 3.0 cria vídeo com som a partir de uma instrução, do primeiro fotograma ou do primeiro/último fotograma e de referências multimodais. O seu perfil do fabricante combina storyboards, edição baseada numa fonte e continuação num só modelo, com saída MP4 de 2–30 segundos a 30 fps e resolução de 480p, 720p ou 1080p.

Entradas aceites
Texto · Imagens
Resultados
Vídeo

Disponível no Ailoot · entradas e métodos

Ailoot Ultra · Vídeo POST /v1/videos
Entrada
text, image
Saída
video
Formato de saída
bytes MP4 originais; sem normalização nem transcodificação
CampoTipoRequisitoValores e limitesPredefinição
CampomodelTipostringRequisitoObrigatórioValores e limites
alibaba/wan-3.0
Predefinição—
CampopromptTipostringRequisitoObrigatórioValores e limitesPredefinição—
CampodurationTipointegerRequisitoObrigatórioValores e limites
2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
Mínimo: 1
Máximo: 600
Predefinição—
CamporesolutionTipostringRequisitoOpcionalValores e limites
480p, 720p, 1080p
Predefinição—
Campoaspect_ratioTipostringRequisitoOpcionalValores e limites
16:9, 4:3, 1:1, 3:4, 9:16
Predefinição—
Campogenerate_audioTipobooleanRequisitoOpcionalValores e limites
false, true
Predefinição—
Campoframe_imagesTipoarrayRequisitoOpcionalValores e limites
Número mínimo de elementos: 1
Número máximo de elementos: 1
Conteúdo de entrada: Matriz de objetos de fotograma. Cada objeto tem type=image_url, image_url com url e frame_type. Utilize um URL HTTPS de imagem e defina frame_type como first_frame. Cada função de fotograma aparece, no máximo, uma vez.
Chaves exatas: type, image_url, frame_type
Condições: Estas chaves descrevem cada objeto de fotograma; image_url contém apenas url. Omita frame_images num pedido apenas de texto.
Predefinição—
Campoinput_referencesTipoarrayRequisitoOpcionalValores e limitesPredefiniçã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 prompt como texto e duration em segundos inteiros. Escolha uma resolução suportada e, se necessário, uma proporção.

model: Tipo: string · alibaba/wan-3.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 do primeiro fotograma. · Obrigatório: model, prompt, duration, frame_images

frame_images é uma matriz. Cada objeto de fotograma tem type, image_url e frame_type; image_url contém url. Defina type como image_url. Utilize first_frame. Cada função de fotograma aparece, no máximo, uma vez. Forneça um URL HTTPS público de imagem para cada fotograma. Escolha uma resolução suportada e, se necessário, uma proporção.

Chaves exatas: type, image_url, frame_type

model: Tipo: string · alibaba/wan-3.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 suportadas. · Obrigatório: model, prompt, duration, input_references

input_references é uma matriz de objetos. Defina type como image_url e utilize o campo correspondente que contém url. Utilize URLs HTTPS públicos. Omita frame_images para selecionar o modo de referência. Escolha uma resolução suportada e, se necessário, uma proporção.

model: Tipo: string · alibaba/wan-3.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âmetroContrato
Parâmetrocontent_typeContratoapplication/json
ParâmetrorequiredContratomodel, prompt, duration
Parâmetromaterial_typesContratotext, image
Parâmetroadditional_propertiesContratofalse
Parâmetrooptional_controlsContratoresolution, aspect_ratio, generate_audio, frame_images, input_references, 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 do vídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor segundo de vídeoCondições de faturaçãoresolution: 1080pCusto
Saída · Preço do vídeo · Estimativa apenas para comparação $0.4 por segundo de vídeo
ConfiguraçãoPreço do vídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor segundo de vídeoCondições de faturaçãoresolution: 480pCusto
Saída · Preço do vídeo · Estimativa apenas para comparação $0.1 por segundo de vídeo
ConfiguraçãoPreço do vídeoTabela de tarifas—Quantidade prevista—Unidade de faturaçãopor segundo de vídeoCondições de faturaçãoresolution: 720pCusto
Saída · Preço do vídeo · Estimativa apenas para comparação $0.2 por segundo de vídeo
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.2 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 do vídeoCondições de faturaçãoresolution: 480pCusto
Saída · Preço do vídeo $0.1 por segundo de vídeo

Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.

ConfiguraçãoPreço do vídeoCondições de faturaçãoresolution: 720pCusto
Saída · Preço do vídeo $0.2 por segundo de vídeo

Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.

ConfiguraçãoPreço do vídeoCondições de faturaçãoresolution: 1080pCusto
Saída · Preço do vídeo $0.4 por segundo de vídeo

Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.

Exemplos de pedidos

Ailoot Ultra · Vídeo

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

Receber e guardar os resultados

Ailoot Ultra · Vídeo

URLs assinados para conteúdo pertencente ao utilizador

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Verificar o estado da tarefa
GET estado da operação original
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Outras leituras de conteúdo
Guardar cada saída concluída de que é titular
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
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 alibaba/wan-3.0

Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

IDs de chamada relacionados

alibaba/wan-3.0

FAQ · Alibaba: Wan 3.0
Que entradas e resultados estão disponíveis?

POST /v1/videos · alibaba/wan-3.0: text, image → video

Que campos utiliza o pedido?

POST /v1/videos · alibaba/wan-3.0: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

Que limites se aplicam?

POST /v1/videos · alibaba/wan-3.0: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 1; frame_images.min_items: 1; seed.minimum: -9223372036854775808; seed.maximum: 9223372036854775807

Mais detalhes

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

A empresa e a sua carteira de projetos

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

Compre tokens com desconto.

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

Subscrição
Escolha um plano com desconto para os pedidos regulares.
Código promocional até 50%
Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.
Custos no histórico
O modelo, os tokens e o montante são guardados para cada pedido.

Escolher subscrição · Ver preços dos modelos

Ligue a API ao produto que vende.

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

Aplicação comercial
Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.
Licença de revendedor
Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.
Documentos no site
A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

Pedir licença de revendedor · Oferta e contrato de licença