Source: https://ailoot.ai/models/pt-pt/alibaba-wan-2-7/ Canonical: https://ailoot.ai/models/pt-pt/alibaba-wan-2-7/ Language: pt-pt # Alibaba: Wan 2.7 [Markdown](https://ailoot.ai/models/pt-pt/alibaba-wan-2-7/index.md) · [JSON](https://ailoot.ai/models/pt-pt/alibaba-wan-2-7/facts.json) ## [Alibaba: Wan 2.7](https://ailoot.ai/models/pt-pt/alibaba-wan-2-7/) Alibaba Wan 2.7 cria vídeos com som a partir de texto, imagens de início e fim ou referências visuais. O fluxo baseado em imagens também prolonga um vídeo de origem, usando a duração total pedida. O fabricante indica MP4 em 720p ou 1080p a 30 fps: 2–15 segundos para os modos de texto/imagem e até 10 segundos para geração a partir de referências. - [**Ailoot Ultra · Vídeo** `POST /v1/videos` `alibaba/wan-2.7`](https://ailoot.ai/models/pt-pt/alibaba-wan-2-7/#method-0) Sobre o modelo Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo. Alibaba Wan 2.7 é uma família de geração de vídeo com perfis identificados de texto para vídeo, imagem para vídeo e orientação por referências. O fabricante documenta cenas com áudio sincronizado e narrativas de vários planos, enquanto o seu fluxo de imagem acrescenta geração com primeiro/último fotograma e continuação de um vídeo inicial. O resultado útil é um clipe curto com o seu som, como uma transição de produto, uma história compacta ou uma continuação que se ajusta a um plano existente. Selecione o modo a partir do material de origem e do controlo necessário sobre o início ou o fim. Para texto para vídeo, descreva o sujeito, o cenário, a ação, a câmara, o estilo e o som. Um storyboard pode identificar cada plano e intervalo de tempo, enquanto as instruções para um único plano devem dizer que a ação permanece contínua. O guia de instruções de Wan 2.7 deixa o modelo interpretar a estrutura dos planos a partir das instruções escritas, em vez de utilizar o controlo shot\_type da versão 2.6. A API atual de texto aceita instruções em chinês ou inglês até 5 000 caracteres, com uma instrução negativa separada de 500 caracteres; o texto excedente é truncado. Mantenha claras a ação essencial e as restrições dentro desse limite. Imagem para vídeo a partir do primeiro fotograma anima uma imagem inicial fornecida. A geração com primeiro/último fotograma define também o extremo final e o movimento que o liga ao início. O guia de imagem da versão 2.7 suporta uma fonte de áudio para orientar a geração em conjunto com essas combinações de fotogramas. Prepare extremos que partilhem uma cena e um sujeito pretendido e descreva a transição, em vez de pedir ao modelo que reinterprete ambas as imagens como referências de estilo sem relação entre si. A saída aproxima-se das proporções da primeira imagem; o guia trata a resolução como um escalão de contagem de píxeis e arredonda as dimensões codificadas de forma adequada. A continuação de vídeo começa com um clipe de origem e pode utilizar também uma imagem final. A duração pedida é a duração total do vídeo devolvido, incluindo o segmento original. O exemplo do guia combina uma fonte de dois segundos com dez segundos de conteúdo novo num resultado de doze segundos. Prepare a ação final da fonte e diga o que acontece depois, para que a câmara e o sujeito continuem numa direção coerente. Reveja a junção quanto ao aspeto, ao movimento, à luz e ao som, em vez de avaliar apenas o novo final gerado. O perfil atual separado de referências do fabricante utiliza imagens ou vídeo para orientar personagens, objetos ou uma cena. O seu guia permite até cinco imagens e vídeos de referência no total e utiliza rótulos específicos do tipo, como Image 1 e Video 1. Descreva o papel de cada material e a interação pretendida. Numa cena guiada por referências, mostre uma personagem de uma referência a transportar o objeto de outra através de um local especificado. O enquadramento por referências difere da geração a partir do primeiro fotograma: as instruções podem estabelecer uma nova composição, em vez de exigir que o vídeo comece numa imagem fixa fornecida. Para áudio personalizado na geração por texto, os formatos documentados são WAV e MP3, com duração entre dois e trinta segundos e um máximo de 15 MB. A duração selecionada para o vídeo determina a parte utilizada: o áudio mais longo é cortado nessa duração, enquanto áudio mais curto do que o vídeo deixa o restante em silêncio. Prepare a passagem de áudio exata que pertence ao plano e deixe espaço para a ação visual pretendida. Sem um ficheiro de áudio fornecido, o fabricante descreve a geração de música de fundo ou efeitos adequados à cena; inspecione o som efetivo e qualquer fala pedida juntamente com a imagem. A matriz atual do modelo apresenta MP4 a 720p ou 1080p e 30 fps, com saída de texto e imagem entre dois e quinze segundos. O perfil separado de referências está limitado a dois a dez segundos. A geração por texto oferece enquadramentos 16:9, 9:16, 1:1, 4:3 e 3:4. As tarefas condicionadas por imagem utilizam as suas próprias regras de aproximação à proporção da fonte, pelo que deve preparar o recorte de entrada para o destino pretendido. Uma regra de duração ou proporção do perfil de referências não deve substituir a do fluxo por fotogramas ou continuação. O fluxo documentado do fabricante é assíncrono: um identificador de tarefa acompanha o processamento e um resultado bem-sucedido fornece a localização do vídeo. Os resultados estão documentados com uma validade de ligação de vinte e quatro horas, pelo que deve conservar o clipe efetivo e os materiais criativos para revisão da montagem. As opções de reescrita de instruções, marca de água e semente pertencem à interface selecionada. O fabricante indica que uma semente fixa pode melhorar a reprodutibilidade, mas não garante um resultado idêntico. Compare o recurso devolvido com as instruções, em vez de presumir que as definições, por si só, preservam todos os pormenores. Em comparação com Wan 2.6, o guia de imagem da versão 2.7 acrescenta especificamente controlo do primeiro/último fotograma e continuação de vídeo através de entradas de recursos multimodais. Wan 3.0 introduz uma estrutura integrada diferente e um limite de geração mais longo. Este perfil 2.7 mantém os seus controlos e limites específicos por tarefa. Reveja a cena inteira quanto à continuidade dos sujeitos, aos fotogramas de ancoragem, à identidade das referências, ao diálogo, ao movimento e às junções e torne a correção seguinte específica para o problema efetivo encontrado. **Ailoot Ultra · Vídeo** `POST /v1/videos` `alibaba/wan-2.7` [`alibaba/wan-2.7`](https://ailoot.ai/models/pt-pt/#m=alibaba%2Fwan-2.7&route=Ultra&caller=alibaba%2Fwan-2.7&fmt=videos) Alibaba /`alibaba/wan-2.7` ### Introdução Alibaba Wan 2.7 cria vídeos com som a partir de texto, imagens de início e fim ou referências visuais. O fluxo baseado em imagens também prolonga um vídeo de origem, usando a duração total pedida. O fabricante indica MP4 em 720p ou 1080p a 30 fps: 2–15 segundos para os modos de texto/imagem e até 10 segundos para geração a partir de referências. Entradas aceites Texto Resultados Vídeo ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Vídeo** `POST /v1/videos` Entrada `text` Saída `video` Formato de saída mp4 Número de saídas Até 4 saídas | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites alibaba/wan-2.7 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites Número máximo de bytes UTF-8: 10 000 São obrigatórios caracteres que não sejam espaços: Sim | Predefinição— | | Campo`duration` | Tipo`integer` | RequisitoObrigatório | Valores e limites 2, 3, 4, 5, 6, 7, 8, 9, 10 | Predefinição— | | Campo`resolution` | Tipo`string` | RequisitoObrigatório | Valores e limites 720p | Predefinição— | | Campo`aspect_ratio` | Tipo`string` | RequisitoObrigatório | Valores e limites 16:9, 9:16, 1:1, 4:3, 3:4 | Predefinição— | | Campo`generate_audio` | Tipo`boolean` | RequisitoObrigatório | Valores e limites false, true | Predefinição— | Combinações de materiais de entrada **Texto para vídeo** · Obrigatório: prompt Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, prompt, duration, resolution, aspect\_ratio, generate\_audio | | Parâmetro`additional_properties` | Contratofalse | | Parâmetro`parameters` | Contrato{"name":"model","type":"string","required":true,"enum":\["alibaba/wan-2.7"\]}, {"name":"prompt","type":"string","required":true,"non\_whitespace":true,"max\_utf8\_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":\[2,3,4,5,6,7,8,9,10\]}, {"name":"resolution","type":"string","required":true,"enum":\["720p"\]}, {"name":"aspect\_ratio","type":"string","required":true,"enum":\["16:9","9:16","1:1","4:3","3:4"\]}, {"name":"generate\_audio","type":"boolean","required":true,"enum":\[false,true\]} | | Parâmetro`material_types` | Contratotext | Aliases do método: `/v1/videos/generations`, `/videos`, `/videos/generations` Ciclo de vida: `submit_once_poll_original` `GET /v1/videos/{request_id}` `GET /v1/videos/generations/{request_id}` `GET /v1/videos/{request_id}/content` `GET /v1/videos/generations/{request_id}/content` Conserve a resposta completa e os IDs originais devolvidos. Nunca volte a enviar uma criação de resultado desconhecido. ### 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 | Opções de geração de áudio | Resolução | Unidade de faturação | Custo | | --- | --- | --- | --- | --- | --- | --- | | ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Opções de geração de áudio— | Resolução— | Unidade 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çãoUltra | Tabela de tarifas— | Quantidade previstaConfiguração solicitada; apenas uma estimativa. | Opções de geração de áudioSem áudio · Com áudio | Resolução720p | Unidade de faturaçãopor segundo de vídeo de saída | Custo Saída · segundo estimado de vídeo · Estimativa apenas para comparação **$0.2** por segundo de vídeo de saída A tarifa apresentada estima o custo antes da geração. A cobrança final é calculada a partir do custo registado para a geração original. A duração física do vídeo não é a quantidade faturável. | | ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Opções de geração de áudio— | Resolução— | Unidade de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$0.4** estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. | O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/) #### Detalhes da tarifa de referência As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado. Referências de preços das configurações de vídeo #### Preços por configuração | Configuração | Condições de faturação | Custo | | --- | --- | --- | | ConfiguraçãoPreço do vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo 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. | ### Exemplos de pedidos #### Ailoot Ultra · Vídeo curl · perfil exatamente como configurado ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "alibaba/wan-2.7", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}') Path('request.json').write_text(json.dumps(p,ensure_ascii=False)) 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 mp4 - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/videos/generations/{request_id}/content` ##### Verificar o estado da tarefa GET estado da operação original ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_STATUS_URL' import json from pathlib import Path from urllib.parse import quote r=json.loads(Path('result.json').read_text()) if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID') Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe='')) PY_STATUS_URL curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \ -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path('status.json').read_text()) print(json.dumps(r,ensure_ascii=False,indent=2)) print('Keep the complete JSON and response headers; do not resubmit an unknown creation.') PY_RESULT ``` Outras leituras de conteúdo Guardar cada saída concluída de que é titular ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_ASSETS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path('status.json').read_text()) if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job') if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied') urls=[] for i,u in enumerate(r.get('data',[])): if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape') urls.append((str(i),u)) for label,path in urls: u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u) if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL') target=Path('owned-'+label+'.bin') subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True) print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.') PY_ASSETS ``` ##### Guardar todos os resultados concluídos Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido. Conserve todos os URL assinados de data\[\] concluído pertencentes ao utilizador e todos os metadados do estado. Guarde todas as saídas, incluindo o áudio gerado. Pode existir uma faixa de áudio AAC válida mesmo com generate\_audio=false; conserve o MP4 original completo, incluindo esse áudio. ##### Se for necessário verificar a resposta original Consulte a tarefa original existente; nunca volte a enviar um pedido cujo envio tenha resultado desconhecido. Número máximo de saídas: 4. Campos da resposta | Campo | Tipo | Significado | | --- | --- | --- | | Campo`id` | Tipostring | Significado— | | Campo`object` | Tipostring | Significado— | | Campo`model` | Tipostring | Significado— | | Campo`status` | Tipostring | Significado— | | Campo`data[]` | Tiposigned content URL | Significado— | | Campo`charge_pending_check` | Tipoboolean | Significado— | | Campo`error.code` | Tipostring | Significado— | | Campo`error.message` | Tipostring | Significado— | | Campo`operation_id` | Tipostring | SignificadoResposta HTTP503 result\_pending\_check do estado/conteúdo original: o mesmo ID público da operação de vídeo original como id. | | Campo`error.type` | Tipostring | Significadoserver\_error na resposta HTTP503 result\_pending\_check. | Erros e passos seguintes | Resposta | Condição | Passo seguinte | | --- | --- | --- | | Resposta400 · `invalid_request_error` | CondiçãoA leitura do corpo bruto do pedido falha antes da análise do perfil de vídeo | Passo seguinteConserve a resposta devolvida e corrija o corpo ilegível do pedido. | | Resposta422 · `price_unavailable` | CondiçãoA análise do perfil exato de vídeo falha ou o perfil completo analisado não tem uma ficha exata de preços pronta | Passo seguinteConserve a resposta; utilize o perfil completo e exato autorizado e a respetiva ficha publicada. Este ramo é executado antes de qualquer envio ao fornecedor. | | Resposta409 · `video_not_ready` | CondiçãoO conteúdo do resultado original ainda não está disponível | Passo seguinteConsulte periodicamente o ID original devolvido e respeite Retry-After. | | Resposta`server_error` | CondiçãoA resposta devolvida indica que a operação ou o resultado requer verificação | Passo seguinteGuarde o ID original da operação/tarefa devolvido, os cabeçalhos do pedido e a resposta; continue a consultar essa operação original através das consultas suportadas. Não volte a enviar o pedido de criação. | | Resposta503 · `result_pending_check` | CondiçãoGET do estado/conteúdo original: a tarefa não está publicada, a tarefa original não está failed/cancelled/expired e o estado local é unknown ou o estado da tarefa original é completed. | Passo seguinteConserve id e operation\_id originais (o mesmo ID público de vídeo), a resposta e os cabeçalhos; consulte apenas o estado/conteúdo original. Nunca envie um novo pedido de geração. | ### Aliases #### Aliases do modelo **Ailoot Ultra** [`alibaba/wan-2.7`](https://ailoot.ai/models/pt-pt/#m=alibaba%2Fwan-2.7&route=Ultra&caller=alibaba%2Fwan-2.7&fmt=videos) #### Aliases dos caminhos dos métodos `/v1/videos/generations`, `/videos`, `/videos/generations` #### IDs de chamada relacionados [`alibaba/wan-2.7`](https://ailoot.ai/models/pt-pt/#m=alibaba%2Fwan-2.7&route=Ultra&caller=alibaba%2Fwan-2.7&fmt=videos) FAQ · Alibaba: Wan 2.7 Que entradas e resultados estão disponíveis? `POST /v1/videos` · `alibaba/wan-2.7`: `text` → `video` Que campos utiliza o pedido? `POST /v1/videos` · `alibaba/wan-2.7`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio` Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.