grok-imagine-video-1.5
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/generationsgrok-imagine-video-1.5 - Ailoot · Vídeo
POST /v1/videos/generationsgrok-imagine-video-1.5-2026-05-30
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
grok-imagine-video-1.5grok-imagine-video-1.5grok-imagine-video-1.5-2026-05-30
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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites grok-imagine-video-1.5 | Predefinição— |
Campoprompt | Tipostring | RequisitoOpcional | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Campoduration | Tipointeger | 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 |
Camposeconds | Tipointeger|integer_string | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 15 Alternativa: duration | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 480p, 720p, 1080p | Predefinição480p |
Campoaspect_ratio | Tipostring | 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 |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1280x720, 720x1280, 1920x1080, 1080x1920 Condições: Tem de coincidir com resolution/aspect_ratio se ambos forem especificados | Predefinição— |
Campoimage | Tipoobject | 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âmetromaterial_types | Contratotext |
Parâmetrorequired | Contratonull |
Parâmetrooptional_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
POST /v1/videos/generations- 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 →
Exemplos de pedidos
Ailoot · Vídeo
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", "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}/contentGET /v1/videos/generations/{request_id}/content
Verificar o estado da tarefa
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
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.mp4Guardar 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 |
|---|---|
Camporequest_id | Tipostring |
Campoid | Tipostring |
Campostatus | Tipostring |
Campovideo.url | Tipoowned signed content URL |
Campovideo.duration | Tiponumber |
Campovideo.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. |
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. |
Aliases
Aliases do modelo
Ailoot grok-imagine-video-1.5, grok-imagine-video-1.5-2026-05-30
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
Ailoot · Vídeo POST /v1/videos/generations grok-imagine-video-1.5-2026-05-30
grok-imagine-video-1.5-2026-05-30
grok-imagine-video-1.5-2026-05-30grok-imagine-video-1.5grok-imagine-video-1.5-2026-05-30
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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites grok-imagine-video-1.5-2026-05-30 | Predefinição— |
Campoprompt | Tipostring | RequisitoOpcional | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Campoduration | Tipointeger | 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 |
Camposeconds | Tipointeger|integer_string | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 15 Alternativa: duration | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 480p, 720p, 1080p | Predefinição480p |
Campoaspect_ratio | Tipostring | 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 |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1280x720, 720x1280, 1920x1080, 1080x1920 Condições: Tem de coincidir com resolution/aspect_ratio se ambos forem especificados | Predefinição— |
Campoimage | Tipoobject | 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âmetromaterial_types | Contratotext |
Parâmetrorequired | Contratonull |
Parâmetrooptional_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
POST /v1/videos/generations- 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 →
Exemplos de pedidos
Ailoot · Vídeo
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-2026-05-30", "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}/contentGET /v1/videos/generations/{request_id}/content
Verificar o estado da tarefa
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
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.mp4Guardar 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 |
|---|---|
Camporequest_id | Tipostring |
Campoid | Tipostring |
Campostatus | Tipostring |
Campovideo.url | Tipoowned signed content URL |
Campovideo.duration | Tiponumber |
Campovideo.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. |
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. |
Aliases
Aliases do modelo
Ailoot grok-imagine-video-1.5, grok-imagine-video-1.5-2026-05-30
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · grok-imagine-video-1.5
- Que entradas e resultados estão disponíveis?
POST /v1/videos/generations·grok-imagine-video-1.5:text→videoPOST /v1/videos/generations·grok-imagine-video-1.5-2026-05-30:text→video- Que campos utiliza o pedido?
POST /v1/videos/generations·grok-imagine-video-1.5:model,prompt,duration,seconds,resolution,aspect_ratio,size,imagePOST /v1/videos/generations·grok-imagine-video-1.5-2026-05-30:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Que limites se aplicam?
POST /v1/videos/generations·grok-imagine-video-1.5:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15POST /v1/videos/generations·grok-imagine-video-1.5-2026-05-30:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15