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-FastIntroduçã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
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites MiniMax-Hailuo-2.3-Fast | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 Comprimento máximo: 199 Unidade: carateres Unicode | Predefinição— |
Campoduration | Tipointeger | RequisitoObrigatório | Valores e limites 6 Unidade: segundos | Predefinição— |
Camporesolution | Tipostring | RequisitoObrigatório | Valores e limites 768P | Predefinição— |
Campofirst_frame_image | Tipohttps_url | RequisitoObrigatório | Valores 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âmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, duration, resolution, first_frame_image |
Parâmetroother_options | Contratofalse |
Parâmetroduration | Contrato6 |
Parâmetroresolution | Contrato768P |
Parâmetroprompt_max_characters | Contrato199 |
Parâmetrofirst_frame_image | Contrato{"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_types | Contratotext, image |
Parâmetroadditional_properties | Contratofalse |
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ção | Tabela de tarifas | Duração nominal do clip, em segundos | Resolução | Unidade de faturação | Custo |
|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Duraçã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çãoUltra | Tabela de tarifas— | Duração nominal do clip, em segundos6 | Resolução768P | Unidade de faturaçãopor clip de saída com duração nominal de 6s | Custo 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ção | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoMiniMax-Hailuo-2.3-Fast · Configuração predefinida | Condições de faturaçãoConfiguração predefinida | Custo 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ção | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoMiniMax-Hailuo-2.3-Fast · Configuração predefinida | Condições de faturaçãoConfiguração predefinida | Custo 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ção | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoMiniMax-Hailuo-2.3-Fast · Configuração predefinida | Condições de faturaçãoConfiguração predefinida | Custo Entrada · Entrada 0,00 US$ por chamada Saída · Saída 0,80 US$ por chamada |
Exemplos de pedidos
Ailoot Ultra · Vídeo
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}/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.
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
| 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— |
Camporequested_nominal_duration_seconds | Tipointeger | Significado— |
Campomeasured_duration_seconds | Tiponumber | Significado— |
Campowidth | Tipointeger | Significado— |
Campoheight | Tipointeger | Significado— |
Campooperation_id | Tipostring | SignificadoDevolvido quando status=unknown; ID público real da operação de vídeo original |
Camporequest_id | Tipostring | SignificadoOpcional quando status=unknown; devolvido apenas se a tarefa original tiver um ID de pedido |
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. |
Resposta200 · video_result_unverified | CondiçãoO estado da tarefa Fast original é desconhecido; status=unknown e charge_pending_check=true | Passo 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
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