Proporções, Resoluções e Gestão de Custos
Nesta página
Atualizado a 3 de novembro de 2026 com base na documentação de vídeo da xAI: a API aceita nove proporções (incluindo
21:9e5:2) e três resoluções, dependendo1080pdo modelo; os três modelos de vídeo têm preços próprios; e o parâmetrosize, com as suas dimensões em píxeis, apresentado na versão anterior, não consta da referência da API. Fontes: Geração de Vídeo · API de Vídeos · Preços.
Otimize as Suas Gerações de Vídeo
Saber escrever um prompt não é suficiente para passar para a produção. Dois fatores determinam o resto: o enquadramento técnico dos seus resultados e o controlo de custos. Um estúdio que gere duzentos clipes por mês sem uma estratégia de prototipagem paga várias vezes o preço necessário, e uma equipa que descobre no final de um projeto que o seu formato não corresponde ao canal de distribuição tem de recomeçar. Esta lição aborda ambos os pontos em conjunto, pois informam-se mutuamente.
Escolha a Proporção Correta
O parâmetro aspect_ratio define as proporções do vídeo gerado. São aceites nove valores, cada um correspondendo a um destino de distribuição específico.
| Proporção | Proporções | Utilização Principal |
|---|---|---|
16:9 | Paisagem widescreen | YouTube, apresentações, websites |
9:16 | Retrato | TikTok, Stories, Reels |
1:1 | Quadrado | Publicações sociais, miniaturas |
4:3 | Paisagem clássica | Documentos, diapositivos |
3:4 | Retrato clássico | Pinterest, cartazes |
3:2 | Paisagem fotográfica | Portfólios, galerias |
2:3 | Retrato fotográfico | Cartazes, capas |
21:9 | Cinema widescreen | Planos cinematográficos |
5:2 | Faixa | Faixas web, cabeçalhos |
Na ausência de um parâmetro explícito, a API aplica 16:9. Esta é uma predefinição razoável para a web, mas torna-se uma armadilha assim que trabalha com formatos verticais: uma campanha destinada a Reels deve declarar 9:16 em cada pedido, caso contrário, irá obter paisagens que necessitarão de corte, com a perda de composição que isso implica. Dois modos estão isentos desta definição: na imagem-para-vídeo, o resultado segue a proporção da imagem de origem e, na edição, a do vídeo de origem.
Três Resoluções, Dependendo do Modelo
O parâmetro resolution aceita três valores. O valor predefinido, 480p, destina-se a pré-visualizações e rascunhos: a renderização é mais rápida, tornando-o num campo de testes ideal para validar um prompt antes de o executar novamente na qualidade final. 720p corresponde à qualidade HD suficiente para a maioria dos usos web e móveis. 1080p, finalmente, oferece Full HD, mas não em todos os modelos:
| Modelo | Resolução Máxima |
|---|---|
grok-imagine-video-1.5 | 1080p nativo (720p em referência-para-vídeo) |
grok-imagine-video-1.5-lite | 1080p, via upsampling a partir de 720p |
grok-imagine-video | 720p |
A edição não é ajustável: o vídeo produzido mantém a resolução da fonte, limitada a 720p. E não existe nenhuma definição mais fina do que estes passos: a referência da API não fornece nenhum parâmetro de tamanho em píxeis. Se a sua distribuição exigir dimensões exatas, escolha a proporção e resolução mais próximas e faça o corte na edição.
{
"model": "grok-imagine-video-1.5",
"prompt": "A sua descrição",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
O Custo Real da Produção
O preço é contado por segundo de vídeo gerado e depende do modelo: $0.020 para grok-imagine-video-1.5-lite, $0.050 para grok-imagine-video e $0.080 para grok-imagine-video-1.5. A progressão é perfeitamente linear, o que torna o orçamento previsível.
| Duração | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 segundo | $0.02 | $0.05 | $0.08 |
| 3 segundos | $0.06 | $0.15 | $0.24 |
| 5 segundos | $0.10 | $0.25 | $0.40 |
| 8 segundos (predefinição) | $0.16 | $0.40 | $0.64 |
| 10 segundos | $0.20 | $0.50 | $0.80 |
| 15 segundos | $0.30 | $0.75 | $1.20 |
A partir de 3 de novembro de 2026, a página Models da xAI exibe um único preço por segundo para cada modelo, sem distinção de resolução, enquanto a página Video Overview refere preços “por resolução”: verifique a grelha antes de comprometer um lote grande.
A primeira alavanca de otimização é a escolha do modelo. A xAI recomenda grok-imagine-video-1.5-lite, quatro vezes mais barato que a versão 1.5, para vídeos simples, e grok-imagine-video-1.5 quando necessita de imagens de referência, vozes, imagens impostas ou 1080p nativo; a edição e a extensão, entretanto, só funcionam com grok-imagine-video. A segunda alavanca é o número de tentativas. Prototipe sistematicamente curto: valide a direção do movimento em dois ou três segundos antes de se comprometer com uma geração de dez ou quinze segundos. Refine o prompt até que esteja correto na primeira tentativa, uma vez que cada regeneração paga o preço total. Execute estes testes em 480p: o preço exibido não muda, mas o tempo de geração reduzido permite-lhe iterar mais rapidamente. E tenha em mente o limite de taxa ao planear um lote.
Este raciocínio calcula-se facilmente. Para um projeto de vinte vídeos de cinco segundos com grok-imagine-video, a produção bruta ascende a 20 × $0.25, ou seja, $5.00 ($2.00 com a versão lite, $8.00 com a 1.5). Assuma duas iterações médias por vídeo e estará em $10.00. Adicione uma margem de experimentação de 50% e apresentará um orçamento de $15.00 que se manterá. Esta é a ordem de grandeza a comunicar a um cliente, não o custo teórico do primeiro cálculo.
Gestão de Limites de Taxa
Os limites da API são contados em pedidos por segundo, por modelo, e crescem com o nível da sua equipa, que por sua vez é fixado pelos seus gastos cumulativos: no nível de entrada, os modelos de vídeo aceitam 10 pedidos por segundo, e a API responde 429 Too Many Requests além desse limite (Limites de taxa). No uso comum, este limite é raramente atingido: como a geração é assíncrona e longa, passa mais tempo à espera do que a submeter. O risco surge em lotes maciços lançados em paralelo, onde algumas linhas de código podem saturar a quota num instante. Espaçar as submissões é suficiente para se manter dentro dos limites.
import asyncio
async def soumettre_lot(prompts, par_seconde=5):
"""Submete gerações sem exceder o limite de taxa."""
for prompt in prompts:
await soumettre_video(prompt) # POST, sem aguardar a conclusão
await asyncio.sleep(1 / par_seconde)
Para lotes muito grandes que podem esperar, a API Batch oferece outro caminho: os seus pedidos não contam para os limites de taxa, e os três modelos de vídeo aceitam-na (apenas em certas regiões para grok-imagine-video e grok-imagine-video-1.5). Não espere poupanças: o desconto do Batch aplica-se apenas a modelos de texto, e o vídeo é faturado à taxa standard. O processamento é geralmente feito em 24 horas, sem garantia.
Entregue o Vídeo Sem o Descarregar
Última definição útil na produção: o parâmetro output.upload_url designa um URL assinado (S3 ou GCS presigned, Azure SAS) para o qual o vídeo será enviado automaticamente via HTTP PUT, com o cabeçalho Content-Type: video/mp4, assim que for gerado.
{
"model": "grok-imagine-video",
"prompt": "A sua descrição",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
Na prática, isto remove um passo inteiro do seu pipeline: não há necessidade de descarregar cada ficheiro e depois enviá-lo para o seu armazenamento, o vídeo chega diretamente ao seu destino. Num fluxo de várias dezenas de clipes por dia, isso significa menos código de transferência e tratamento de erros para manter.
Preços registados a 3 de novembro de 2026 — os preços evoluem regularmente: antes de qualquer cálculo orçamental, verifique a grelha atual na página oficial de modelos e preços da xAI.
Pontos-chave
- Estão disponíveis nove proporções,
16:9por predefinição; em imagem-para-vídeo, o resultado segue a proporção da imagem - Três resoluções: 480p (predefinição), 720p e 1080p, esta última apenas nos modelos 1.5
- Nenhum parâmetro define um tamanho em píxeis: proporção e resolução são suficientes
- O preço é linear, por segundo: $0.020, $0.050 ou $0.080 dependendo do modelo
- Prototipe curto, em 480p, com o modelo mais barato que seja suficiente
output.upload_urlautomatiza a entrega; a API Batch contorna os limites de taxa, sem desconto no vídeo