Source: https://ailoot.ai/models/pt-pt/grok-imagine-video/ Canonical: https://ailoot.ai/models/pt-pt/grok-imagine-video/ Language: pt-pt # grok-imagine-video [Markdown](https://ailoot.ai/models/pt-pt/grok-imagine-video/index.md) · [JSON](https://ailoot.ai/models/pt-pt/grok-imagine-video/facts.json) ## [grok-imagine-video](https://ailoot.ai/models/pt-pt/grok-imagine-video/) O Grok Imagine Video cria vídeos curtos a partir de uma descrição em texto, com escolha da duração e do formato de enquadramento. O próprio modelo da xAI suporta também animação de imagens e edição de vídeo orientada por instruções. - [**Ailoot · Vídeo** `POST /v1/videos/generations` `grok-imagine-video`](https://ailoot.ai/models/pt-pt/grok-imagine-video/#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. #### Da descrição ao vídeo O Grok Imagine Video cria vídeo a partir de texto. O próprio modelo da xAI tem também modos que utilizam uma imagem ou um vídeo de origem. No método de geração publicado pela Ailoot, a entrada é uma descrição textual, e o resultado, um vídeo. A geração é assíncrona: primeiro é criada uma tarefa; depois, o seu identificador permite obter o estado e o resultado pronto. Segundo a xAI, a criação de um vídeo pode demorar vários minutos; o tempo depende da complexidade da cena, da duração, da resolução e do modo escolhido. #### Duração e enquadramento Para criar um vídeo, está disponível uma duração entre **1 e 15 segundos**. Os formatos de enquadramento incluem `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` e `2:3`; o formato padrão é `16:9`. Esta versão prevê **480p e 720p**; 1080p pertence à versão 1.5. #### Animação de uma imagem de origem No modo da xAI com imagem, esta torna-se o fotograma inicial, e a instrução textual define o movimento. Por predefinição, o formato do vídeo reproduz as proporções da imagem de origem. Uma proporção definida explicitamente altera esse formato e pode esticar a imagem. #### Edição orientada por instruções Ao trabalhar com um vídeo pronto, o modelo aplica as alterações descritas, preservando o restante conteúdo da cena. Este modo ajuda a alterar um elemento específico mantendo a encenação do vídeo de origem. A duração e as proporções são herdadas do original; não são definidas uma nova duração ou um novo formato de enquadramento. O vídeo de origem para edição está limitado a **8,7 segundos**, e o resultado, a uma resolução não superior a **720p**. Material em 1080p é reduzido para 720p. As configurações da geração a partir de texto não se aplicam automaticamente à edição. #### Continuação de um vídeo pronto Num modo separado da xAI, esta versão prolonga o vídeo de origem a partir do seu último fotograma. O MP4 de origem tem de durar entre 2 e 15 segundos; a parte acrescentada, entre 2 e 10 segundos, com 6 como valor predefinido. O resultado combina o vídeo original e a continuação. As proporções e a resolução são herdadas da origem, com um limite de 720p; não é possível alterá-las separadamente neste modo. Esta capacidade do fabricante é distinta da geração Ailoot publicada a partir de texto. #### Referências e limites da versão A xAI prevê a utilização de referências visuais para orientar o aspeto das pessoas, da roupa e dos objetos na cena. Uma referência define características visuais, e não a imagem exata do fotograma inicial. No Grok Imagine Video clássico, não é possível combinar um fotograma inicial com referências. Esta versão não aceita a fixação exata do último fotograma nem fotogramas-chave intermédios. Estas capacidades pertencem ao Grok Imagine Video 1.5. A geração, a animação de uma imagem de origem e a alteração de um vídeo pronto são modos diferentes; o método Ailoot aqui publicado descreve a geração a partir de texto. **Ailoot · Vídeo** `POST /v1/videos/generations` `grok-imagine-video` [`grok-imagine-video`](https://ailoot.ai/models/pt-pt/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos) xAI /`grok-imagine-video` ### Introdução O Grok Imagine Video cria vídeos curtos a partir de uma descrição em texto, com escolha da duração e do formato de enquadramento. O próprio modelo da xAI suporta também animação de imagens e edição de vídeo orientada por instruções. 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 | 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 | 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,002 US$ *por imagem de entrada* Entrada 0,01 US$ *por segundo de vídeo de entrada* Saída 0,05 US$ *por segundo a 480p* Saída 0,07 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", "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`](https://ailoot.ai/models/pt-pt/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`grok-imagine-video`](https://ailoot.ai/models/pt-pt/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos) FAQ · grok-imagine-video Que entradas e resultados estão disponíveis? `POST /v1/videos/generations` · `grok-imagine-video`: `text` → `video` Que campos utiliza o pedido? `POST /v1/videos/generations` · `grok-imagine-video`: `model`, `prompt`, `duration`, `seconds`, `resolution`, `aspect_ratio`, `size`, `image` Que limites se aplicam? `POST /v1/videos/generations` · `grok-imagine-video`: `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.