API Grok Imagine 1.5: transforme imagens em vídeos curtos

Uma única foto de produto, um retrato ou um frame estático de paisagem pode se transformar em um clipe de vídeo curto utilizável, sem precisar fazer login em outra conta de geração de vídeo. O endpoint de imagem para vídeo do Grok Imagine 1.5 recebe uma URL de imagem, um prompt opcional que descreve o movimento e uma duração, e retorna o arquivo .mp4 renderizado por meio da API de tarefas assíncronas da hiapi.

Este walkthrough usa a mesma imagem de origem e dois prompts diferentes para mostrar o quanto a redação pode mudar o resultado. Em seguida, detalha o schema real da requisição, os preços e fornece um exemplo de código pronto para copiar.

Imagem de origem

Os dois clipes abaixo começam a partir deste mesmo frame estático. Entre as duas requisições, a imagem base não muda em nada — apenas o campo prompt é diferente.

Versão 1: travelling curto no estilo teaser

Prompt: “Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.” Duração: 4.

Versão 2: movimento orbital mais longo

Prompt: “Camera slowly orbits around the subject, revealing the scene from a new angle.” Duração: 8.

O mesmo frame estático, o mesmo modelo, dois movimentos de câmera completamente diferentes — aqui quase tudo depende do prompt, porque a requisição não tem parâmetros dedicados de intensidade de movimento ou trajetória de câmera.

O schema real da requisição

Consulte a página do modelo de imagem para vídeo Grok Imagine 1.5 para a documentação completa do modelo e os preços atualizados. O corpo da requisição é deliberadamente pequeno:

{
  "model": "grok-imagine-1.5/image-to-video",
  "input": {
    "image_urls": ["https://your-public-host.com/source.jpg"],
    "prompt": "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.",
    "duration": 4
  }
}

Três coisas você precisa saber antes de chamar:

• image_urls precisa ser uma URL HTTP(S) pública. O modelo busca a imagem por conta própria — não é possível enviar bytes brutos no corpo da requisição. Se a sua imagem de origem só existe localmente, faça upload primeiro para qualquer bucket de armazenamento público.
• duration é um inteiro de 1 a 15 segundos. Não há campos aspect_ratio, resolution ou intensidade de movimento — a composição de saída segue a imagem de origem, e a resolução é determinada pela faixa de preço (480p ou 720p), não por parâmetros da requisição.
• prompt é opcional, mas assume a maior parte do trabalho criativo, porque não há mais nada para orientar a câmera.

Enviar e consultar a tarefa

Como todos os modelos de vídeo e imagem na hiapi, este modelo é executado por meio da API unificada de tarefas assíncronas, não de um endpoint síncrono — a geração leva tempo real, então você precisa enviar a tarefa, consultar o status de conclusão e baixar o resultado antes que o link expire.

# 1. Submit the task
curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5/image-to-video",
    "input": {
      "image_urls": ["https://your-public-host.com/source.jpg"],
      "prompt": "Camera slowly orbits around the subject, revealing the scene from a new angle.",
      "duration": 8
    }
  }'
# => {"id": "task_...", "status": "pending"}

# 2. Poll until it's done
curl -s https://api.hiapi.ai/v1/tasks/task_... \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# => {"id": "task_...", "status": "success", "output": [{"url": "https://...mp4"}]}

Assim que status se tornar success, baixe imediatamente output[0].url — é um link com tempo limitado, não um link permanente, portanto salve os bytes no seu próprio armazenamento antes que expire.

Preços e cálculo de duração

Antes de orçar tarefas em lote, confirme os números atuais na página de preços da hiapi, mas até a data deste artigo, grok-imagine-1.5/image-to-video cobra por segundo de saída:

Resolução	Preço por segundo
480p	$0.015
720p	$0.0282

Um clipe de 4 segundos em 480p custa $0.06; o mesmo clipe em 720p custa cerca de $0.11. Como o preço escala com a duração e não com uma taxa fixa por geração, testar várias variantes de prompt no mesmo frame estático antes de definir a edição final tem custo baixo — os dois clipes deste artigo custam juntos bem menos que $0.20.

Perguntas frequentes

Posso controlar diretamente o movimento da câmera em vez de descrevê-lo no prompt? Não — o schema deste endpoint não tem parâmetros dedicados de intensidade de movimento, trajetória de câmera ou zoom. O comportamento da câmera é totalmente dirigido por como você formula o prompt.

A resolução de saída corresponde à minha imagem de origem? A composição segue a proporção da imagem de origem, mas a resolução (480p ou 720p) é definida pela faixa de preço escolhida, e não por um campo separado — consulte o schema atual na página do modelo linkada acima, porque os modelos da plataforma ocasionalmente adicionam parâmetros.

O que acontece se eu não baixar a saída rápido o suficiente? O output[0].url de uma tarefa concluída tem tempo limitado. Se perder a janela, será necessário reenviar a tarefa e pagar novamente pela geração — não é possível recuperar um link expirado.

Posso animar várias imagens estáticas em uma única requisição? image_urls aceita uma URL, mas cada tarefa gera um clipe a partir de uma imagem de origem. Para tarefas em lote, envie uma tarefa por frame estático e consulte cada uma separadamente — o modelo assíncrono significa que você pode ter várias tarefas em andamento ao mesmo tempo.

---

Pronto para testar com as suas próprias imagens? Gere um clipe curto com os seus próprios prompts na página do modelo de imagem para vídeo Grok Imagine 1.5, ou, se for integrá-lo a um pipeline existente, comece pela documentação da API de tarefas assíncronas.