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.
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.7Introduçã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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites alibaba/wan-2.7 | Predefinição— |
Campoprompt | Tipostring | 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— |
Campoduration | Tipointeger | RequisitoObrigatório | Valores e limites 2, 3, 4, 5, 6, 7, 8, 9, 10 | Predefinição— |
Camporesolution | Tipostring | RequisitoObrigatório | Valores e limites 720p | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoObrigatório | Valores e limites 16:9, 9:16, 1:1, 4:3, 3:4 | Predefinição— |
Campogenerate_audio | Tipoboolean | 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âmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parâmetroadditional_properties | Contratofalse |
Parâmetroparameters | 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âmetromaterial_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 →
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
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}/contentGET /v1/videos/generations/{request_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 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 |
|---|---|---|
Campoid | Tipostring | Significado— |
Campoobject | Tipostring | Significado— |
Campomodel | Tipostring | Significado— |
Campostatus | Tipostring | Significado— |
Campodata[] | Tiposigned content URL | Significado— |
Campocharge_pending_check | Tipoboolean | Significado— |
Campoerror.code | Tipostring | Significado— |
Campoerror.message | Tipostring | Significado— |
Campooperation_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. |
Campoerror.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. |
Respostaserver_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
Aliases dos caminhos dos métodos
/v1/videos/generations, /videos, /videos/generations
IDs de chamada relacionados
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