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.
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-videoIntroduçã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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites grok-imagine-video | 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 | 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,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 →
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", "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
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
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