Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Proporções, Resoluções e Gestão de Custos

Aula 3 de 12 Atualizada a 3 de novembro de 2026 Intermediario
Nesta página
  1. Otimize as Suas Gerações de Vídeo
  2. Escolha a Proporção Correta
  3. Três Resoluções, Dependendo do Modelo
  4. O Custo Real da Produção
  5. Gestão de Limites de Taxa
  6. Entregue o Vídeo Sem o Descarregar
  7. Pontos-chave

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:9 e 5:2) e três resoluções, dependendo 1080p do modelo; os três modelos de vídeo têm preços próprios; e o parâmetro size, 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çãoProporçõesUtilização Principal
16:9Paisagem widescreenYouTube, apresentações, websites
9:16RetratoTikTok, Stories, Reels
1:1QuadradoPublicações sociais, miniaturas
4:3Paisagem clássicaDocumentos, diapositivos
3:4Retrato clássicoPinterest, cartazes
3:2Paisagem fotográficaPortfólios, galerias
2:3Retrato fotográficoCartazes, capas
21:9Cinema widescreenPlanos cinematográficos
5:2FaixaFaixas 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:

ModeloResolução Máxima
grok-imagine-video-1.51080p nativo (720p em referência-para-vídeo)
grok-imagine-video-1.5-lite1080p, via upsampling a partir de 720p
grok-imagine-video720p

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ção1.5-litegrok-imagine-video1.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:9 por 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_url automatiza a entrega; a API Batch contorna os limites de taxa, sem desconto no vídeo