xAI
Grok Imagine
grok-imagine/text-to-video
Modelo de geração criativa da xAI, com suporte a edição imagem-para-imagem e direcionamento de estilo, podendo usar até 9 imagens de referência para controlar composição e personagens; chamado por meio da interface unificada do HiAPI.ai
Experimentar grok-imagine/text-to-video
Entrada
Criações
Ver todas as criaçõesSaída
videoPreços
grok-imagine/text-to-video per second
| Especificações | Preço unitário |
|---|---|
| 480P | $0.0114 |
| 720P | $0.0214 |
| 1080P | $0.05714 |
Visão geral do posicionamento
grok-imagine/text-to-video é a linha da série Grok Imagine da xAI responsável pela geração de vídeo a partir de texto, chamada por meio da interface unificada do HiAPI.ai: basta um prompt de texto para gerar um vídeo curto. Ela oferece três modos de estilo de movimento — fun, normal e spicy —, permite controlar a duração entre 6 e 30 segundos e escolher a qualidade de imagem entre 480p, 720p e 1080p, com formatos de tela que cobrem paisagem, retrato e quadrado. É adequada para desenvolvedores que precisam produzir rapidamente vídeos curtos para redes sociais, protótipos de ideias publicitárias ou pré-visualizações dinâmicas de storyboard e integrá-los ao produto.
Destaques principais
- Três modos de movimento ajustáveis ao estilo do vídeo — as três opções fun, normal e spicy correspondem, respectivamente, a uma expressão criativa mais forte, a uma expressão equilibrada e a uma sensação de movimento mais intensa; o mesmo prompt pode alternar o ritmo conforme a necessidade de veiculação.
- Duração e resolução combináveis conforme a necessidade — cada geração aceita de 6 a 30 segundos e resolução selecionável entre 480p, 720p e 1080p, permitindo equilibrar velocidade de geração, qualidade de imagem e custo.
- Vários formatos de tela para os principais posicionamentos de veiculação de uma só vez — já inclui cinco formatos: 16:9, 9:16, 1:1, 3:2 e 2:3; materiais em paisagem, retrato e quadrado podem ser usados sem recorte adicional.
Descrição das capacidades
Geração de vídeo diretamente a partir de texto: basta enviar um prompt de até 5000 caracteres para obter um vídeo, sem precisar de imagens de referência ou material de storyboard, ideal para produzir vídeos rapidamente do zero.
Parâmetros de geração controláveis: duração, resolução, proporção de tela e modo de movimento são parâmetros de entrada explícitos; os desenvolvedores podem fixá-los ou enviá-los dinamicamente na requisição conforme o cenário de negócio.
Estilo de movimento ajustável: o parâmetro mode influencia o estilo e a intensidade do movimento na imagem, permitindo alternar entre expressão criativa e sensação de movimento conforme o tipo de conteúdo.
Cenários de uso
- Gestores de redes sociais: gerar vídeos em formato vertical a partir de uma descrição textual — usar proporção 9:16 com duração mais curta para gerar materiais verticais, utilizáveis diretamente em plataformas de vídeos curtos ou anúncios em feed.
- Equipes de criação publicitária: produzir em lote vídeos conceituais de roteiros — gerar prompts de diferentes direções criativas como vídeos de 6 a 30 segundos, para concorrência interna e pré-visualização criativa.
- Desenvolvedores de produtos: integrar a capacidade de texto para vídeo ao aplicativo — conectar a capacidade de geração por meio da interface unificada, permitindo que usuários finais obtenham um clipe de vídeo para download apenas inserindo uma descrição.
Limitações e recomendações de escolha
Cada geração fica limitada a 6 a 30 segundos, não sendo possível produzir uma tomada mais longa de uma só vez; narrativas longas exigem a divisão em vários trechos e a montagem posterior. Embora o prompt aceite chinês, descrições em inglês tendem a produzir resultados visuais mais estáveis; conteúdos multilíngues exigem avaliação própria. A combinação de resolução e duração afeta o tempo de geração; para priorizar velocidade, prefira 480p e durações mais curtas. Cenários que exigem orientar a imagem com base em imagens de referência ou que requerem sincronia entre áudio e vídeo devem usar a linha de imagem para vídeo ou ferramentas com capacidade de áudio.
Novidades
Ver o changelog →- Novo modelo Novos modelos: grok-imagine-image-2.0/text-to-image e grok-imagine-ima…
Perguntas frequentes
Ver todas as perguntas →-
Para que serve o nível padrão do Grok Imagine?
Indicado para exploração criativa em lote, materiais para redes sociais e cenas de paisagem com estilo cinematográfico. 1k e 2k estão atualmente com o mesmo preço, por isso vale a pena escolher diretamente o nível de saída mais alto.
-
Qual é a diferença entre o plano Standard e o plano Quality?
O plano Standard prioriza velocidade e preço fixo baixo; o Quality é uma linha de modelo independente, que dá mais atenção a materiais, detalhes e iluminação, e é cobrado por faixas de 1k/2k.
-
Quais proporções de imagem são suportadas?
Suporta 13 proporções de imagem nas orientações horizontal, quadrada e vertical, de 2:1 e 20:9 até 1:2.
-
Esta página suporta imagens de referência?
Não. Para edição com imagem de referência, use grok-imagine/image-to-image.
Criar uma tarefa de geração
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.
Idempotency-KeystringOpcionalChave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.
Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.
Corpo
modelstringObrigatórioValor fixo atual: grok-imagine/text-to-video
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para grok-imagine/text-to-video e a rota default — veja a tabela de parâmetros abaixo.
modestringOpcionalPadrão: "normal"Modo de geração, que controla o estilo e a intensidade do movimento: fun é mais criativo, normal é equilibrado e spicy tem movimentos mais dinâmicos. O padrão é normal.
funnormalspicypromptstringObrigatóriominLength 1maxLength 5000Prompt de texto que descreve a cena e o movimento desejados no vídeo; funciona melhor em inglês e tem no máximo 5000 caracteres.
durationintegerOpcionalPadrão: 6min 6max 30Duração do vídeo em segundos; o custo é calculado por segundo. O padrão é 6 segundos.
resolutionstringOpcionalPadrão: "480p"Resolução do vídeo de saída: 720p tem qualidade superior, 480p gera mais rápido e com menor custo, e 1080p tem a qualidade mais alta. O padrão é 480p.
480p720p1080paspect_ratiostringOpcionalPadrão: "2:3"Proporção da tela do vídeo de saída. O padrão é 2:3.
2:33:21:116:99:16callbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.
urlstringObrigatórioObrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.
whenstringOpcionalPadrão: "final"Atualmente só há suporte a final — notifica tanto em success quanto em fail.
finalstoragestringOpcionalPadrão: "temp"Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.
temppersistentExemplos de requisição
# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine/text-to-video",
"input": {
"mode": "normal",
"prompt": "…",
"duration": 6,
"resolution": "480p",
"aspect_ratio": "2:3"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "grok-imagine/text-to-video",
input: {
"mode": "normal",
"prompt": "…",
"duration": 6,
"resolution": "480p",
"aspect_ratio": "2:3"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "grok-imagine/text-to-video",
"input": {
"mode": "normal",
"prompt": "…",
"duration": 6,
"resolution": "480p",
"aspect_ratio": "2:3"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obter detalhes da tarefa
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
queued Na fila, ainda não iniciada.
handling Em processamento.
archiving Processamento concluído, preparando artefatos.
success Terminal: concluído, artefatos disponíveis (retorna output).
fail Terminal: falha (retorna error).
Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.
creatednumberObrigatórioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos Unix do estado terminal; 0 enquanto não terminal.
outputarrayOpcional
Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).
Array [ object ]
Itens do array
urlstringObrigatórioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescrição do erro.
Exemplos de resposta
Sucesso
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Em processamento (não final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Falhou
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artigos
Ver todos os artigos →-
Tutorial
Como usar kling-4.0/text-to-video através da API HiAPI: curl, Python e um exemplo de requisição executável
Guia prático para desenvolvedores: prompts cinematográficos, áudio sincronizado, polling assíncrono e download da saída
-
Tutorial
Como chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
Tutorial
Como chamar hailuo-2.3-fast/image-to-video pela API HiAPI: curl e Python na prática
A primeira requisição executável do nível rápido e econômico de geração de vídeo a partir de imagem — do ID do modelo ao download do MP4
-
Tutorial
Usar Kandinsky 6.0 Pro text-to-video na HiAPI: tutorial de curl e Python
Demonstração prática com foco na requisição: montar a chamada de prompt para clipe de vídeo, enviar a requisição, consultar o status de conclusão e baixar o resultado
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video na HiAPI: curl + Python
Faça uma requisição de imagem para vídeo funcional na HiAPI: do upload do primeiro quadro ao polling assíncrono e ao download final
-
Tutorial
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Kandinsky 6.0 Pro $1.93 /vídeo -
Creatify Boreal Creatify $0.015 /segundo -
Vidu Q4 Preview Vidu $0.051 /segundo -
Kling 3.0 Turbo Kuaishou $0.130 /segundo -
Grok Imagine 1.5 Lite xAI $0.029 /segundo -
Seedance 2.5 ByteDance $0.121 /segundo -
Ray 3.2 Luma $0.214 /vídeo -
HeyGen Avatar V HeyGen $0.150 /segundo -
LTX 2.5 Fast Lightricks $0.086 /segundo -
Wan 2.7 Video Alibaba $0.100 /segundo -
PixVerse V6 PixVerse $0.036 /segundo