Source: https://ailoot.ai/models/pt-pt/minimax-hailuo-2-3-fast/
Canonical: https://ailoot.ai/models/pt-pt/minimax-hailuo-2-3-fast/
Language: pt-pt

# Hailuo 2.3 Fast

[Markdown](https://ailoot.ai/models/pt-pt/minimax-hailuo-2-3-fast/index.md) · [JSON](https://ailoot.ai/models/pt-pt/minimax-hailuo-2-3-fast/facts.json)

## [Hailuo 2.3 Fast](https://ailoot.ai/models/pt-pt/minimax-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.

- [**Ailoot Ultra · Vídeo** `POST /v1/videos` `MiniMax-Hailuo-2.3-Fast`](https://ailoot.ai/models/pt-pt/minimax-hailuo-2-3-fast/#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.

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`](https://ailoot.ai/models/pt-pt/#m=MiniMax-Hailuo-2.3-Fast&route=Ultra&caller=MiniMax-Hailuo-2.3-Fast&fmt=videos)

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

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites MiniMax-Hailuo-2.3-Fast | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 Comprimento máximo: 199 Unidade: carateres Unicode | Predefinição— |
| Campo`duration` | Tipo`integer` | RequisitoObrigatório | Valores e limites 6 Unidade: segundos | Predefinição— |
| Campo`resolution` | Tipo`string` | RequisitoObrigatório | Valores e limites 768P | Predefinição— |
| Campo`first_frame_image` | Tipo`https_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âmetro`content_type` | Contratoapplication/json |
| Parâmetro`required` | Contratomodel, prompt, duration, resolution, first\_frame\_image |
| Parâmetro`other_options` | Contratofalse |
| Parâmetro`duration` | Contrato6 |
| Parâmetro`resolution` | Contrato768P |
| Parâmetro`prompt_max_characters` | Contrato199 |
| Parâmetro`first_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âmetro`material_types` | Contratotext, image |
| Parâmetro`additional_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 →](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.

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

curl · pedido de criação preservado sem alterações

```bash
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

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

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 |
| --- | --- | --- |
| 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`requested_nominal_duration_seconds` | Tipointeger | Significado— |
| Campo`measured_duration_seconds` | Tiponumber | Significado— |
| Campo`width` | Tipointeger | Significado— |
| Campo`height` | Tipointeger | Significado— |
| Campo`operation_id` | Tipostring | SignificadoDevolvido quando status=unknown; ID público real da operação de vídeo original |
| Campo`request_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. |
| 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. |
| 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`](https://ailoot.ai/models/pt-pt/#m=MiniMax-Hailuo-2.3-Fast&route=Ultra&caller=MiniMax-Hailuo-2.3-Fast&fmt=videos)

#### Aliases dos caminhos dos métodos

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

#### IDs de chamada relacionados

[`MiniMax-Hailuo-2.3-Fast`](https://ailoot.ai/models/pt-pt/#m=MiniMax-Hailuo-2.3-Fast&route=Ultra&caller=MiniMax-Hailuo-2.3-Fast&fmt=videos)

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`

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.