Source: https://ailoot.ai/models/pt-pt/grok-imagine-video-1-5-preview/
Canonical: https://ailoot.ai/models/pt-pt/grok-imagine-video-1-5-preview/
Language: pt-pt

# grok-imagine-video-1.5-preview

[Markdown](https://ailoot.ai/models/pt-pt/grok-imagine-video-1-5-preview/index.md) · [JSON](https://ailoot.ai/models/pt-pt/grok-imagine-video-1-5-preview/facts.json)

## [grok-imagine-video-1.5-preview](https://ailoot.ai/models/pt-pt/grok-imagine-video-1-5-preview/)

O Grok Imagine Video 1.5 cria vídeos a partir de texto com duração de 1–15 segundos, incluindo em 1080p. O próprio modelo suporta animação de imagens, referências visuais, definição de fotogramas-chave e uma faixa sonora.

- [**Ailoot · Vídeo** `POST /v1/videos/generations` `grok-imagine-video-1.5-preview`](https://ailoot.ai/models/pt-pt/grok-imagine-video-1-5-preview/#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.

#### Criação de uma cena em vídeo

O Grok Imagine Video 1.5 é um modelo da xAI para gerar vídeos a partir de descrições textuais e material visual. O método Ailoot atual publica a geração a partir de texto; modos adicionais do próprio modelo permitem animar uma imagem, utilizar referências e definir fotogramas de referência da cena.

O resultado é criado de forma assíncrona: depois de a tarefa ser submetida, a prontidão é verificada através do seu identificador. Segundo a xAI, o processo pode demorar vários minutos, consoante a complexidade da cena, a duração e a resolução. Receber o identificador de uma tarefa ainda não significa que o vídeo esteja pronto.

#### Duração, proporções e resolução

O vídeo criado tem uma duração entre **1 e 15 segundos**. Pode escolher-se `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` ou `2:3`; para texto, o formato padrão é `16:9`. Na animação de uma imagem, as suas proporções são preservadas por predefinição.

Para a geração a partir de texto e de uma imagem inicial, estão disponíveis **480p, 720p e 1080p**. O valor predefinido é 480p; o modo com referências está limitado a 720p. A resolução 1080p não se aplica a todos os modos apenas por estar disponível no modelo.

#### Controlo do aspeto visual

No modo com referências, a xAI aceita até **7 imagens**. Estas definem pessoas, objetos, roupa e outras características visuais, sem fixarem o fotograma inicial. Esta forma de trabalho destina-se a cenas com uma personagem recorrente, demonstração de produtos e preservação do aspeto pretendido entre cenas.

#### Primeiro, último e fotogramas intermédios

A versão 1.5 permite fixar o primeiro fotograma exato, o último fotograma exato ou ambos. Se apenas o último for definido, o modelo constrói o início e chega à imagem indicada. Quando os dois extremos são definidos, cria o movimento entre eles; a instrução textual pode especificar o movimento e o trabalho da câmara.

Para estruturar o vídeo por dentro, é possível fixar até **4 fotogramas-chave**. O tempo de cada um tem de ser estritamente posterior ao início e anterior ao fim; a posição é definida numa grelha de **1/3 de segundo**. Dois fotogramas que sejam arredondados para a mesma posição da grelha são rejeitados. Para o evitar, deixe pelo menos 1/3 de segundo entre eles. O primeiro e o último fotogramas são definidos separadamente destes quatro fotogramas intermédios.

Os fotogramas de referência podem ser combinados com referências visuais e vozes predefinidas. Se pelo menos um fotograma estiver fixado, a descrição textual é opcional: a própria sequência de imagens define a cena. Os fotogramas-chave não podem ser utilizados com o modo de edição de vídeo. Estas capacidades da xAI não significam que estejam disponíveis na geração Ailoot publicada a partir de texto.

#### Som e vozes

Por predefinição, o vídeo criado contém uma faixa sonora; está também previsto um resultado sem som. No modo da xAI com referências de voz, podem escolher-se até **3 vozes predefinidas** e associá-las aos participantes que falam na cena.

O envio de um ficheiro de áudio próprio como amostra de voz não é uma capacidade geral deste modelo: a xAI disponibiliza-o separadamente mediante pedido. Uma voz predefinida e áudio carregado são tipos de entrada diferentes.

#### Modos de trabalho

A geração a partir de texto cria uma nova cena; uma imagem inicial define o seu início; as referências orientam o aspeto; os fotogramas fixados definem pontos visuais no tempo. Cada modo tem os seus próprios limites, pelo que as configurações de uma forma de trabalho não podem ser aplicadas incondicionalmente a outra.

**Ailoot · Vídeo** `POST /v1/videos/generations` `grok-imagine-video-1.5-preview`

[`grok-imagine-video-1.5-preview`](https://ailoot.ai/models/pt-pt/#m=grok-imagine-video-1.5-preview&route=Core&caller=grok-imagine-video-1.5-preview&fmt=videos)

xAI /`grok-imagine-video-1.5-preview`

### Introdução

O Grok Imagine Video 1.5 cria vídeos a partir de texto com duração de 1–15 segundos, incluindo em 1080p. O próprio modelo suporta animação de imagens, referências visuais, definição de fotogramas-chave e uma faixa sonora.

Entradas aceites

Texto

Resultados

Vídeo

### Disponível no Ailoot · entradas e métodos

**Ailoot · Vídeo** `POST /v1/videos/generations`

Entrada

`text`

Saída

`video`

Formato de saída

mp4

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites grok-imagine-video-1.5-preview | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoOpcional | Valores e limites Comprimento mínimo: 1 | Predefinição— |
| Campo`duration` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 15 Condições: Não forneça duration e seconds em simultâneo Unidade: segundos | Predefinição1 |
| Campo`seconds` | Tipo`integer\|integer_string` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 15 Alternativa: duration | Predefinição— |
| Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores e limites 480p, 720p, 1080p | Predefinição480p |
| Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Condições: Se for fornecida uma imagem de entrada e a proporção for omitida, o fornecedor herda a proporção da imagem | Predefinição16:9 |
| Campo`size` | Tipo`string` | RequisitoOpcional | Valores e limites 1280x720, 720x1280, 1920x1080, 1080x1920 Condições: Tem de coincidir com resolution/aspect\_ratio se ambos forem especificados | Predefinição— |
| Campo`image` | Tipo`object` | RequisitoOpcional | Valores e limites Condições: Imagem de entrada real e suportada; permite omitir a instrução | Predefinição— |

Combinações de materiais de entrada

**Texto para vídeo** · Obrigatório: prompt

**Imagem para vídeo** · Obrigatório: image

Parâmetros e ciclo de vida do método

| Parâmetro | Contrato |
| --- | --- |
| Parâmetro`material_types` | Contratotext |
| Parâmetro`required` | Contratonull |
| Parâmetro`optional_controls` | Contratonull |

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`

As estruturas dos métodos e os ID são exatos; a capacidade do fornecedor é distinta da admissão dos pedidos.

### Tarifários

#### Tarifas dos métodos Ailoot

Entrada

0,01 US$ *por imagem de entrada*

Saída

0,25 US$ *por segundo a 1080p*

Saída

0,08 US$ *por segundo a 480p*

Saída

0,14 US$ *por segundo a 720p*

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/)

### Exemplos de pedidos

#### Ailoot · Vídeo

Exemplo de vídeo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'
```

### Receber e guardar os resultados

#### Ailoot · 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

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Outras leituras de conteúdo

GET conteúdo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4
```

##### Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve o JSON completo do estado e o request\_id real. Uma resposta concluída com status=done contém video.url com um URL de conteúdo pertencente ao utilizador. Preserve a duração indicada e todos os campos de resultado devolvidos.

##### Se for necessário verificar a resposta original

Consulte a tarefa original existente; nunca volte a enviar um pedido cujo envio tenha resultado desconhecido.

Campos da resposta

| Campo | Tipo |
| --- | --- |
| Campo`request_id` | Tipostring |
| Campo`id` | Tipostring |
| Campo`status` | Tipostring |
| Campo`video.url` | Tipoowned signed content URL |
| Campo`video.duration` | Tiponumber |
| Campo`video.respect_moderation` | Tipoboolean |

Erros e passos seguintes

| Resposta | Condição | Passo seguinte |
| --- | --- | --- |
| Resposta400 · `invalid_request_error` | CondiçãoCampos obrigatórios, representação do material ou valor do parâmetro inválidos | Passo seguinteCorrija os campos indicados antes de um novo pedido de criação. |
| 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. |

### Aliases

#### Aliases do modelo

**Ailoot** [`grok-imagine-video-1.5-preview`](https://ailoot.ai/models/pt-pt/#m=grok-imagine-video-1.5-preview&route=Core&caller=grok-imagine-video-1.5-preview&fmt=videos)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`grok-imagine-video-1.5-preview`](https://ailoot.ai/models/pt-pt/#m=grok-imagine-video-1.5-preview&route=Core&caller=grok-imagine-video-1.5-preview&fmt=videos)

FAQ · grok-imagine-video-1.5-preview

Que entradas e resultados estão disponíveis?

`POST /v1/videos/generations` · `grok-imagine-video-1.5-preview`: `text` → `video`

Que campos utiliza o pedido?

`POST /v1/videos/generations` · `grok-imagine-video-1.5-preview`: `model`, `prompt`, `duration`, `seconds`, `resolution`, `aspect_ratio`, `size`, `image`

Que limites se aplicam?

`POST /v1/videos/generations` · `grok-imagine-video-1.5-preview`: `duration.minimum`: `1`; `duration.maximum`: `15`; `seconds.minimum`: `1`; `seconds.maximum`: `15`

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.
