O que o Grok Imagine descontinuou hoje? Os modelos antigos ainda funcionam? Entenda os 4 pontos essenciais da migração para a versão 2.0

Nota do autor: entenda em um só lugar o alcance da descontinuação do identificador antigo do Grok Imagine, a compatibilidade da interface antiga, as mudanças nos preços oficiais e como controlar qualidade e custos na migração para o 2.0.

Hoje, 2 de novembro de 2026, a xAI executa oficialmente o plano de migração dos modelos de imagem Grok Imagine. O que está sendo descontinuado é o identificador de modelo da API grok-imagine-image-quality, e não o Grok Imagine inteiro. O identificador antigo ainda pode ser usado, mas as solicitações serão processadas pelo grok-imagine-image-2.0 com qualidade Low. O modelo 1.0, grok-imagine-image, não é afetado.

Isso não é um boato, e o 2.0 não foi lançado hoje. A xAI confirmou essa mudança no guia oficial de migração e enviou um aviso prévio de 60 dias em 2 de setembro. As regras de migração e os preços apresentados neste artigo vêm da documentação oficial da xAI.

O essencial: em 3 minutos, descubra se você será afetado, se ainda pode usar a interface antiga, se precisa modificar o código e como escolher o parâmetro de qualidade para controlar os custos.

O que foi descontinuado hoje no Grok Imagine: resumo

O ponto mais fácil de interpretar errado é confundir a “descontinuação do identificador antigo” com a “desativação do serviço”. Segundo a explicação oficial, requisições que usam o nome antigo não vão necessariamente falhar só porque ele foi descontinuado: o servidor vai encaminhá-las para o 2.0. Mas o fato de o identificador antigo ainda funcionar não significa que o modelo antigo continue rodando por trás dele.

Linha do tempo da migração para o Grok Imagine 2.0

• 15 de maio: grok-imagine-image-pro é descontinuado, e as requisições são redirecionadas para grok-imagine-image-quality.
• 7 de agosto: a xAI lança o Imagine Image 2.0, com o nome de API grok-imagine-image-2.0. Os produtos para consumidores também recebem o novo Modo de Qualidade.
• 28 de agosto: a API 2.0 ganha a opção quality=auto, e o valor padrão, quando o parâmetro não é informado, muda de Medium para Auto. O limite de imagens de referência para edição aumenta de 3 para 5, e são adicionadas as proporções 21:9 e 5:2.
• 2 de setembro: a xAI publica as orientações de migração, anunciando que o identificador Quality antigo seria descontinuado em 60 dias.
• 2 de novembro: as regras de migração entram em vigor.

O modelo antigo do Grok Imagine ainda funciona? Quem é afetado pela migração

Para saber se você será afetado, confira primeiro o valor de model no código e nas configurações. Se você só gera imagens no site ou no aplicativo do Grok, lembre-se de que o anúncio se refere diretamente aos identificadores da API. Não dá para concluir que alguma opção da interface foi removida hoje.

Você não precisa alterar o código hoje, pois os identificadores antigos não deixarão de funcionar diretamente por causa dessa descontinuação. Ainda assim, se sua aplicação tem requisitos de estilo, edição ou custo, vale a pena migrar por conta própria. Assim, você pode escolher o modelo e o nível de qualidade.

Vale lembrar que compatibilidade na estrutura da requisição não significa que as imagens serão iguais. Quando o modelo subjacente muda, o mesmo comando pode gerar diferenças de estilo, composição e detalhes. Esse é um risco comum em migrações de modelo. As informações públicas disponíveis não indicam que houve um problema de qualidade em larga escala hoje, mas ainda é recomendável revisar amostras em produção.

Como mudaram os preços do Grok Imagine 2.0: nem todas as opções ficaram mais baratas

A xAI cobra por imagem gerada, e o preço da versão 2.0 depende do nível de qualidade e da resolução. Com a migração automática para Low, cada imagem gerada fica US$ 0,01 mais barata. Já se você escolher Medium, cada imagem custa US$ 0,01 a mais que no antigo Quality.

Além disso, tanto no 2.0 quanto no antigo Quality, cada imagem de referência enviada custa US$ 0,01. No 1.0, o preço por imagem gerada é de US$ 0,02 para 1K e 2K, e cada imagem enviada custa US$ 0,002. Embora a tabela oficial de preços inclua 1.5K, a documentação dos parâmetros de geração menciona explicitamente apenas 1k e 2k. Por isso, não use resolution="1.5k" em código de produção sem antes testar.

Estimativa de custos para geração de imagens em lote com o Grok Imagine

A tabela abaixo usa os preços unitários oficiais e apresenta custos teóricos, não faturas empresariais reais. Nos exemplos de texto para imagem, não estão incluídos o envio de imagens de referência, novas tentativas após falhas, impostos ou taxas de plataformas de terceiros.

Para trabalhos de edição, é preciso incluir o custo de entrada. Por exemplo, ao usar 5 imagens de referência para gerar 1 imagem 2K em Medium, o custo de entrada é de US$ 0,05 e o de saída é de US$ 0,08, totalizando US$ 0,13. A redução oficial de US$ 0,01 por imagem se refere principalmente ao preço de saída. Por isso, não dá para aplicar diretamente ao custo total de edição a mesma redução indicada na tabela para a saída.

Qual é a diferença entre Low, Medium e Auto no Grok Imagine

Low consome menos recursos computacionais e custa menos. É também o nível fixo usado na migração automática do antigo Quality. Medium usa mais recursos computacionais e é voltado a tarefas que exigem mais detalhes na imagem gerada. Já no Auto, a xAI decide a qualidade: atualmente, a regra oficial usa Low para geração de imagens e Medium para edição, mas isso pode mudar no futuro.

Um erro fácil de cometer é alterar model para 2.0 sem preencher quality.

Em uma tarefa de edição com 1 imagem de referência e 1 imagem de saída em 1K, o custo teórico do antigo Quality é de US$ 0,06. Ao mudar para o 2.0 e omitir quality, a tarefa atualmente usa Medium, e o custo passa a ser US$ 0,07. Ao continuar usando o identificador antigo, a tarefa usa Low e custa US$ 0,05. Para manter o orçamento previsível, é recomendável informar sempre o nível de qualidade explicitamente.

Além disso, os níveis Low, Medium e Auto da API não são diretamente equivalentes às opções Fast e Quality do site do Grok. Na documentação, no código e nas descrições do produto, é melhor apresentá-los separadamente para evitar mal-entendidos na equipe.

Como migrar para o Grok Imagine 2.0: parâmetros, verificações e cuidados com o SDK

O caminho recomendado para a migração é simples: altere model para grok-imagine-image-2.0 e defina quality explicitamente conforme as necessidades do seu projeto. O exemplo da interface oficial abaixo segue a estrutura da documentação da xAI. Para executá-lo, é preciso usar uma chave válida. Nenhuma chamada paga foi feita para este artigo.

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A professional technology magazine cover",
    "quality": "low",
    "resolution": "1k",
    "aspect_ratio": "16:9",
    "n": 1
  }'

Para edição de imagens, você pode definir explicitamente a qualidade como Medium. O endereço da imagem no exemplo abaixo é apenas ilustrativo: substitua-o pelo de uma imagem à qual você tenha acesso.

curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Change the background to a clean white studio",
    "quality": "medium",
    "image": {
      "url": "https://example.com/input.jpg",
      "type": "image_url"
    }
  }'

Como confirmar se uma solicitação ao Grok Imagine foi executada no 2.0

Segundo a xAI, o campo model na resposta mostra o modelo que realmente executou a solicitação, não apenas o alias informado pelo cliente. Durante a migração, você pode enviar uma solicitação de teste com o identificador antigo, registrar o model retornado e compará-lo com a cobrança correspondente.

A xAI também permite consultar cost_in_usd_ticks em usage. Basta dividir esse valor por 10000000000 para convertê-lo em dólares. Esse é o comportamento da API oficial; em plataformas de terceiros, é preciso verificar separadamente se esses dados são retornados sem alterações.

Compatibilidade de SDK com a interface de edição do Grok Imagine

A geração de imagens a partir de texto pode ser feita por um cliente compatível com a OpenAI, com parâmetros adicionais como quality em extra_body. Já na edição de imagens, há um detalhe importante: o método images.edit() do SDK da OpenAI usa multipart/form-data, enquanto a interface de edição da xAI exige application/json. Por isso, não é possível reutilizá-lo diretamente. A recomendação oficial é usar o SDK da xAI, o Vercel AI SDK ou uma solicitação HTTP nativa que atenda aos requisitos.

Antes de colocar a integração em produção, confira também estes detalhes técnicos:

• Armazenamento das imagens: por padrão, a resposta traz uma URL temporária. Para guardar arquivos por mais tempo, baixe-os ou transfira-os para outro armazenamento. Também é possível solicitar os dados em Base64.
• Quantidade gerada: n aceita valores de 1 a 10 e o padrão é 1; a resolução padrão é 1K.
• Entrada para edição: é possível usar até 5 imagens de origem, com cobrança de entrada por imagem.
• Limites de requisições: a tabela oficial indica 6 por segundo para T0, 12 para T1, 25 para T2, 50 para T3 e 100 para T4. Consulte o xAI Console para saber seu limite efetivo.
• Processamento em lote: a página do modelo indica suporte à Batch API, mas o preço em lote aparece como N/A. Não presuma que haverá desconto.

Verifique a disponibilidade antes de chamar o Grok Imagine por uma plataforma de agregação

Se você usa uma plataforma de agregação para gerenciar seus modelos, confirme se o modelo desejado está disponível antes de fazer a migração. Não foi possível confirmar de forma independente se o grok-imagine-image-2.0 está disponível atualmente na APIYI, se todos os parâmetros de qualidade são compatíveis ou qual é o preço praticado. Por isso, o código abaixo verifica primeiro a disponibilidade do modelo, mas não garante que ele esteja disponível.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI OpenAI 兼容接口
)

target_model = "grok-imagine-image-2.0"
available_models = {model.id for model in client.models.list()}

if target_model not in available_models:
    raise SystemExit(f"{target_model} 当前不在可用模型列表中")

response = client.images.generate(
    model=target_model,
    prompt="A professional technology magazine cover",
    extra_body={"quality": "low"}
)

print("实际模型:", getattr(response, "model", "响应未返回"))
print("图片地址:", response.data[0].url)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["IMAGE_API_KEY"],
    base_url=os.getenv("IMAGE_API_BASE_URL", "https://api.apiyi.com/v1"),
)

MODEL = "grok-imagine-image-2.0"
QUALITIES = ["low", "medium"]
PROMPTS = [
    "Product photo of a white ceramic mug on a clean studio background",
    "A tech conference poster with the title FUTURE API in large letters",
]


def run_regression():
    """用固定提示词对比质量档位，并记录实际模型和图片地址。"""
    for prompt in PROMPTS:
        for quality in QUALITIES:
            response = client.images.generate(
                model=MODEL,
                prompt=prompt,
                extra_body={"quality": quality},
            )
            print({
                "requested_model": MODEL,
                "actual_model": getattr(response, "model", "not_returned"),
                "quality": quality,
                "prompt": prompt[:30],
                "image_url": response.data[0].url,
            })


if __name__ == "__main__":
    run_regression()

Dica para a migração: consulte primeiro a lista de modelos e as informações de cobrança na APIYI apiyi.com. Depois, faça um pequeno lote de requisições para verificar se os parâmetros são repassados corretamente. Novos usuários podem usar os créditos gratuitos de teste nessa etapa. Se o modelo não estiver disponível, não redirecione o tráfego de produção.

Análise dos impactos da migração para o Grok Imagine 2.0

Impactos para desenvolvedores e equipes de produto

A primeira mudança é que a versão do modelo deixou de ser “óbvia à primeira vista”: uma chamada bem-sucedida não significa que o modelo antigo ainda esteja em execução. Os logs devem registrar tanto o modelo solicitado quanto o modelo indicado na resposta. A segunda é que o orçamento precisa ser calculado para cada rota. Low e Medium costumam ter uma diferença de US$ 0,02 na mesma resolução, então não dá para afirmar de forma genérica que o 2.0 é mais barato. A terceira diz respeito à aceitação do produto: imagens para e-commerce, pôsteres, retratos e edições localizadas devem passar por testes de regressão com exemplos fixos.

Vale a pena atualizar para o Grok Imagine 2.0 pela qualidade?

Por enquanto, é possível confirmar que o modelo em execução mudou para o 2.0, que o nível usado na migração é o Low e que o preço unitário da saída correspondente caiu. Esses fatos, porém, não provam que todas as imagens vão melhorar. A xAI afirma que o 2.0 melhorou o seguimento de instruções com múltiplas condições, a diagramação de texto e a edição de imagens. A empresa também informou que, no dia do lançamento, o modelo ficou em segundo lugar nos rankings de texto para imagem e edição de imagens da Arena — um resultado histórico de 7 de agosto. Registros posteriores da Arena mostram que ele ficou em 6º lugar no ranking geral de texto para imagem em 26 de outubro e em 5º no ranking geral de edição de imagem única em 23 de outubro.

Os testes independentes também precisam ser interpretados levando em conta suas amostras. Na amostra de 12 imagens do Voyager, o tempo por imagem variou de aproximadamente 11 a 95 segundos. Já no ImageBench, a taxa de aprovação nas 192 avaliações foi de cerca de 79%, com latência média de 69 segundos, embora a avaliação automática possa cometer erros. No Reddit, alguns usuários também relataram problemas como suavização excessiva da pele e alterações locais que afetam a imagem inteira. Esses relatos, porém, se referem principalmente a experiências com o produto para consumidores entre agosto e setembro. Eles não podem ser tratados como avaliações da API após o redirecionamento atual, nem representam todos os usuários.

Por isso, vale priorizar testes com o 2.0 para diagramação, pôsteres e imagens com múltiplas condições. Já para retratos fotorrealistas e tarefas de edição que exigem preservar ao máximo a imagem original, é melhor fazer uma implementação gradual e cautelosa. A Arena reflete preferências humanas, não a taxa de aprovação para o seu negócio. No fim, ainda é preciso validar o modelo com suas próprias amostras.

O que observar ao escolher um serviço de API para o Grok Imagine

Ao fazer chamadas por plataformas de terceiros, usar o mesmo nome de modelo não significa que o roteamento para o provedor original e a cobrança sejam iguais. Os preços oficiais da xAI também não são necessariamente os preços praticados por terceiros. Na hora de escolher, vale confirmar cada item:

• Suporte aos modelos: o 2.0 está disponível? O identificador antigo foi mantido? Para qual modelo as chamadas são roteadas de fato?
• Compatibilidade de parâmetros: quality, resolution e aspect_ratio são encaminhados corretamente? Os valores padrão para edição estão claros?
• Transparência de preços: como são calculadas as cobranças pela saída e pela entrada de imagens de referência? É possível relacionar a cobrança a cada solicitação?
• Facilidade de migração: a troca de modelo exige poucas alterações? Os logs refletem mudanças no modelo subjacente?

A APIYI apiyi.com oferece uma interface compatível com OpenAI e permite chamar modelos de diferentes provedores com uma única chave API, o que facilita a comparação e a troca entre modelos. No caso específico do Grok Imagine, ainda vale conferir o suporte e os preços atuais usando a lista acima.

Perguntas frequentes sobre a migração do Grok Imagine

Migração para o Grok Imagine 2.0: pontos principais

• O que foi descontinuado: o identificador grok-imagine-image-quality foi descontinuado hoje, não toda a linha Grok Imagine.
• Compatibilidade: o identificador antigo continua funcionando, mas as chamadas são processadas pelo 2.0 Low. A versão 1.0 não é afetada.
• Mudança de preço: com o Low, cada imagem gerada custa US$ 0,01 a menos; o Medium custa US$ 0,01 a mais que o antigo Quality.
• Atenção ao parâmetro: no 2.0, omitir quality ativa o modo Auto. Atualmente, as edições usam Medium, o que não equivale ao caminho do identificador antigo.
• Como validar: confira o campo model da resposta, a cobrança das requisições e as imagens de exemplo. Não basta verificar se a API retornou sucesso.
• Limitação do SDK: o método images.edit() do SDK da OpenAI não pode ser usado diretamente com a API de edição da xAI.
• Escolha da plataforma: consulte os modelos e a cobrança na APIYI apiyi.com antes de fazer testes em pequenos lotes. Não presuma que a plataforma ofereça suporte ao modelo.

Resumo: o que fazer após a descontinuação do identificador antigo do Grok Imagine

O ponto principal dessa mudança não é a desativação do serviço, mas a troca do modelo por trás do identificador antigo. Para responder às dúvidas mais importantes, podemos resumir em três pontos:

1. O modelo antigo ainda funciona? A versão 1.0 continua disponível; o nome antigo Quality também pode ser usado, mas as chamadas são processadas pelo 2.0 Low.
2. É preciso mudar o código? Não imediatamente, mas é recomendável usar grok-imagine-image-2.0 explicitamente e preencher o parâmetro quality.
3. Como controlar os custos? Em tarefas em lote, teste primeiro o Low. Avalie o Medium quando precisar de mais detalhes e não se esqueça de incluir o custo das imagens de referência nas tarefas de edição.

Como próximo passo, procure o identificador antigo nas configurações e use um conjunto fixo de amostras para testar possíveis mudanças na qualidade e na cobrança. Se precisar comparar vários modelos de imagem, consulte os modelos disponíveis na APIYI apiyi.com, confirme o suporte e só então migre o tráfego aos poucos.

📚 Referências

1. Guia de migração da xAI: desativação dos modelos de imagem em 2 de novembro e regras de redirecionamento
2. Link: docs.x.ai/developers/migration/imagine-image-quality-nov-2

3. Descrição: confirma quais modelos serão desativados, o roteamento para o 2.0 Low, que o 1.0 não será afetado e como fazer a migração

4. Anúncio de lançamento do xAI Image 2.0: data de lançamento e descrição oficial dos recursos

5. Link: x.ai/news/grok-imagine-image-2

6. Descrição: traz informações sobre o lançamento em 7 de agosto; as descrições dos recursos são declarações oficiais

7. Registro de atualizações para desenvolvedores da xAI: Auto como valor padrão e atualizações de agosto

8. Link: docs.x.ai/developers/release-notes

9. Descrição: ajuda a confirmar a cronologia dos parâmetros da API 2.0

10. Tabela oficial de preços da xAI: preços de saída de imagens e entrada de imagens de referência

11. Link: docs.x.ai/developers/pricing

12. Descrição: base para todos os preços unitários oficiais e cálculos de custos teóricos deste artigo

13. Documentação de geração de imagens da xAI: parâmetros como qualidade, resolução e proporção

14. Link: docs.x.ai/developers/model-capabilities/images/generation

15. Descrição: útil para montar os parâmetros da requisição e verificar a resposta

16. Documentação de edição de imagens da xAI: interface de edição e compatibilidade com SDKs

17. Link: docs.x.ai/developers/model-capabilities/images/editing

18. Descrição: confirma a exigência de application/json e as limitações do SDK da OpenAI

19. Documentação da xAI sobre acompanhamento de custos e limites de taxa: custo por requisição e limites da conta

20. Link: docs.x.ai/developers/cost-tracking
21. Link: docs.x.ai/developers/rate-limits

22. Descrição: útil para verificar o custo de cada requisição e planejar a concorrência

23. Ranking do Arena: retratos das classificações de texto para imagem e edição de imagens, com datas identificadas

24. Link: arena.ai/leaderboard/image/text-to-image
25. Link: arena.ai/leaderboard/image/image-edit/single-image

26. Descrição: baseado em avaliações de preferência humana; as posições mudam com o tempo

27. Testes de terceiros: avaliações independentes do Voyager e do ImageBench

28. Link: voyager.so/resources/models/grok-imagine-2
29. Link: imagebench.ai/imagebench-v1/xai--grok-imagine-2
30. Descrição: servem como referência para o desempenho em tarefas específicas, mas não representam a média de todas as plataformas

Autor: Equipe técnica da APIYI
Contato técnico: entre em contato conosco pela página inicial da APIYI em apiyi.com. Para mais informações, acesse o centro de documentação em docs.apiyi.com

Artigos relacionados

• O que o Kimi K3.1 Pro melhorou em relação à geração anterior? Comparação de capacidades e preços: Comparativo de upgrade para usuários atuais do K3: entenda separadamente os dados divulgados oficialmente e os da Artificial Analysis, as cinco faixas de preço, o custo por tarefa, os cuidados na migração e a tabela de decisão “vale a pena trocar/não há pressa”.
• Meu Deus! Krea 3, você vai acabar com o Nano Banana?: Como o Krea 3 se sai na criação de imagens publicitárias para marcas? Este artigo percorre em 5 etapas o fluxo do Ad Studio, do site oficial ao kit de marca e a 12 anúncios estáticos, com imagens oficiais, tabela de custos e 7 armadilhas.
• OpenAI, Anthropic e Google descontinuam modelos antigos em conjunto: os primeiros param já no próximo mês, você está na lista?: Veja em uma página todos os 10 marcos de desativação da OpenAI, Anthropic e Google de 17 de novembro de 2026 a 1 de abril de 2027: quais modelos são afetados, quais são os substitutos, se haverá erros e quais linhas de código alterar.