modelos

Hailuo 2.3 Fast

Markdown · JSON

Hailuo 2.3 Fast

MiniMax Hailuo 2.3 Fast anima uma imagem do primeiro fotograma a partir de uma instrução curta de movimento. Escolha este perfil de imagem para vídeo para um plano de produto, uma pose de personagem ou uma imagem fixa de storyboard.

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.

MiniMax Hailuo 2.3 Fast é o perfil identificado como Fast para geração de imagem para vídeo. Comece com uma imagem composta para o primeiro fotograma e descreva como o sujeito ou a câmara devem mover-se. Uma fotografia de produto, uma pose de personagem ou um fotograma de storyboard dão ao plano um ponto de partida visual concreto.

Prepare a imagem e as instruções de movimento

Forneça uma imagem quadrada PNG ou JPEG através de um URL HTTPS, com cada lado entre 300 e 4 096 píxeis. O ficheiro de imagem transferido não pode exceder 20 000 000 bytes. Mantenha a instrução entre 1 e 199 caracteres, focada numa ação visível e no movimento importante para o plano.

Acompanhe o clipe até à conclusão

Este perfil está configurado para um clipe MP4 de 768 × 768 com uma duração nominal de seis segundos. Envie o pedido uma vez, guarde o ID devolvido e acompanhe esse pedido original até à conclusão. Transfira o vídeo devolvido e conserve as dimensões comunicadas e a duração medida com o resultado. Se o resultado da criação for incerto, continue a verificar o pedido original em vez de o criar novamente.

Ailoot Ultra · Vídeo POST /v1/videos MiniMax-Hailuo-2.3-Fast

MiniMax-Hailuo-2.3-Fast

MiniMax /MiniMax-Hailuo-2.3-Fast

Introdução

MiniMax Hailuo 2.3 Fast anima uma imagem do primeiro fotograma a partir de uma instrução curta de movimento. Escolha este perfil de imagem para vídeo para um plano de produto, uma pose de personagem ou uma imagem fixa de storyboard.

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
mp4
Número de saídas
Até 1 saída
CampoTipoRequisitoValores e limitesPredefinição
CampomodelTipostringRequisitoObrigatórioValores e limites
MiniMax-Hailuo-2.3-Fast
Predefinição—
CampopromptTipostringRequisitoObrigatórioValores e limites
Comprimento mínimo: 1
Comprimento máximo: 199
Unidade: carateres Unicode
Predefinição—
CampodurationTipointegerRequisitoObrigatórioValores e limites
6
Unidade: segundos
Predefinição—
CamporesolutionTipostringRequisitoObrigatórioValores e limites
768P
Predefinição—
Campofirst_frame_imageTipohttps_urlRequisitoObrigatórioValores e limites
Tamanho máximo do ficheiro, em bytes: 20 000 000
Tipos MIME: image/png, image/jpeg
Dimensão mínima: 300
Dimensão máxima: 4096
Apenas quadrado: Sim
Predefinição—
Combinações de materiais de entrada

Imagem para vídeo · Obrigatório: prompt, first_frame_image

Parâmetros e ciclo de vida do método
ParâmetroContrato
Parâmetrocontent_typeContratoapplication/json
ParâmetrorequiredContratomodel, prompt, duration, resolution, first_frame_image
Parâmetroother_optionsContratofalse
ParâmetrodurationContrato6
ParâmetroresolutionContrato768P
Parâmetroprompt_max_charactersContrato199
Parâmetrofirst_frame_imageContrato{"type":"https_url","format":["png","jpeg"],"dimensions":"quadrado de 300..4096 píxeis","full_image_validation_before_send":true,"maximum_file_bytes":20000000}
Parâmetromaterial_typesContratotext, image
Parâmetroadditional_propertiesContratofalse

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

Crie uma única vez e guarde o ID devolvido.

Consulte periodicamente o estado original; conserve todos os recursos concluídos e a respetiva duração.

Tarifários

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 Ailoot

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 tarifasDuração nominal do clip, em segundosResoluçãoUnidade de faturaçãoCusto
ConfiguraçãoTarifas base por tokenTabela de tarifasTarifa baseDuração nominal do clip, em segundos—Resolução—Unidade de faturação—Custo
Entrada · Tokens de entrada — / 1K tokens
Saída · Tokens de saída — / 1K tokens
Entrada · Leitura da cache — / 1K tokens
Entrada · Escrita na cache — / 1K tokens
Entrada · Escrita na cache, 1 hora — / 1K tokens
ConfiguraçãoUltraTabela de tarifas—Duração nominal do clip, em segundos6Resolução768PUnidade de faturaçãopor clip de saída com duração nominal de 6sCusto
Saída · clipe de saída nominal de 6s $0.4 por clip de saída com duração nominal de 6s

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.

MiniMax-Hailuo-2.3-Fast

Preços por configuração

ConfiguraçãoCondições de faturaçãoCusto
ConfiguraçãoMiniMax-Hailuo-2.3-Fast · Configuração predefinidaCondições de faturaçãoConfiguração predefinidaCusto
Entrada · Entrada 0,00 US$ por chamada
Saída · Saída 0,40 US$ por chamada
MiniMax-Hailuo-2.3-Fast

Preços por configuração

ConfiguraçãoCondições de faturaçãoCusto
ConfiguraçãoMiniMax-Hailuo-2.3-Fast · Configuração predefinidaCondições de faturaçãoConfiguração predefinidaCusto
Entrada · Entrada 0,00 US$ por chamada
Saída · Saída 0,80 US$ por chamada
MiniMax-Hailuo-2.3-Fast

Preços por configuração

ConfiguraçãoCondições de faturaçãoCusto
ConfiguraçãoMiniMax-Hailuo-2.3-Fast · Configuração predefinidaCondições de faturaçãoConfiguração predefinidaCusto
Entrada · Entrada 0,00 US$ por chamada
Saída · Saída 0,80 US$ por chamada

Exemplos de pedidos

Ailoot Ultra · Vídeo

curl · pedido de criação preservado sem alterações
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
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

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

data[] concluído contém todos os URLs assinados para conteúdos pertencentes ao utilizador. Obtenha cada URL devolvido ou utilize o endpoint de conteúdo com index definido como um índice real de saída. Uma tarefa original falhada pode devolver charge_pending_check; consulte essa tarefa original em vez de a criar novamente.

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: 1.

Campos da resposta
CampoTipoSignificado
CampoidTipostringSignificado—
CampoobjectTipostringSignificado—
CampomodelTipostringSignificado—
CampostatusTipostringSignificado—
Campodata[]Tiposigned content URLSignificado—
Campocharge_pending_checkTipobooleanSignificado—
Campoerror.codeTipostringSignificado—
Campoerror.messageTipostringSignificado—
Camporequested_nominal_duration_secondsTipointegerSignificado—
Campomeasured_duration_secondsTiponumberSignificado—
CampowidthTipointegerSignificado—
CampoheightTipointegerSignificado—
Campooperation_idTipostringSignificadoDevolvido quando status=unknown; ID público real da operação de vídeo original
Camporequest_idTipostringSignificadoOpcional quando status=unknown; devolvido apenas se a tarefa original tiver um ID de pedido
Erros e passos seguintes
RespostaCondiçãoPasso seguinte
Resposta400 · invalid_request_errorCondiçãoA leitura do corpo bruto do pedido falha antes da análise do perfil de vídeoPasso seguinteConserve a resposta devolvida e corrija o corpo ilegível do pedido.
Resposta422 · price_unavailableCondiçãoA análise do perfil exato de vídeo falha ou o perfil completo analisado não tem uma ficha exata de preços prontaPasso 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_readyCondiçãoO conteúdo do resultado original ainda não está disponívelPasso seguinteConsulte periodicamente o ID original devolvido e respeite Retry-After.
Respostaserver_errorCondiçãoA resposta devolvida indica que a operação ou o resultado requer verificaçãoPasso 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.
Resposta200 · video_result_unverifiedCondiçãoO estado da tarefa Fast original é desconhecido; status=unknown e charge_pending_check=truePasso seguinteConserve o id/operation_id efetivamente devolvido e o request_id opcional; consulte apenas a tarefa original. Nunca volte a enviar.

Aliases

Aliases do modelo

Ailoot Ultra MiniMax-Hailuo-2.3-Fast

Aliases dos caminhos dos métodos

/v1/videos/generations, /videos, /videos/generations

IDs de chamada relacionados

MiniMax-Hailuo-2.3-Fast

FAQ · Hailuo 2.3 Fast
Que entradas e resultados estão disponíveis?

POST /v1/videos · MiniMax-Hailuo-2.3-Fast: text, image → video

Que campos utiliza o pedido?

POST /v1/videos · MiniMax-Hailuo-2.3-Fast: model, prompt, duration, resolution, first_frame_image

Que limites se aplicam?

POST /v1/videos · MiniMax-Hailuo-2.3-Fast: prompt.maximum_length: 199

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