Casa Blog

Como usar a API Image 2.0 do Grok Imagine

Placa de lançamento Grok Imagine Image 2.0

Aug 12, 2026

EmpirioLabs AI

O Grok Imagine Image 2.0 está disponível no EmpirioLabs. O modelo de imagem mais recente do Grok Imagine da xAI gera a partir de um prompt de texto e edita até três imagens fonte a partir de uma instrução em linguagem simples. Qualidade e resolução são ambas selecionáveis, a saída é para 2K, e ele alcança os mesmos endpoints compatíveis com OpenAI que você já usa para todos os outros modelos na plataforma.

Assista ao filme de lançamento

Cada quadro é uma saída real do Grok Imagine Image 2.0. A trilha foi gerada pela ACE-Step em EmpirioLabs.

O que ele suporta

O Grok Imagine Image 2.0 recebe texto e imagens e escreve as imagens. Ele cuida de três tarefas de um único modelo:

  • Texto para imagem. Envie um prompt sem imagem.
  • Edição de imagens. Anexe uma imagem e descreva a mudança que você deseja.
  • Edição multiimagem. Anexe duas ou três imagens para combinar os sujeitos, transferir um estilo ou compor uma cena, e aborde-as no prompt como <IMAGE_0>, <IMAGE_1>, e assim por diante.

A tipografia se mantém bem, que é a parte que a maioria dos modelos de imagem ainda erra. Sinalização, cartazes e etiquetas de produtos retornam com as palavras que você realmente pediu, em vez de um rabisco plausível.

Gerar uma imagem

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Conteúdo: application/json" \ -d '{ "modelo": "grok-imagine-image-2-0", "prompt": "Um telescópio de latão sobre uma mesa de madeira ao lado de um mapa estelar dobrado, luz quente de lâmpada", "qualidade": "média", "resolução": "2k", "aspect_ratio": "16:9" }'

A mesma chamada do SDK Python da OpenAI, apontada para EmpirioLabs:

a partir da importação openai cliente OpenAI = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) resultado = client.images.generate(model="grok-imagine-image-2-0", prompt="Um telescópio de latão em uma mesa de madeira ao lado de um mapa estelar dobrado, luz quente da lâmpada", n=2,) para a imagem em result.data: print(image.url)

Editar uma imagem

Ponto /v1/images/edits em uma URL pública, um URI de dados ou uma imagem que você enviou, e descreva a mudança.

curl https://api.empiriolabs.ai/v1/images/edits \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-de-Conteúdo: application/json" \ -d '{ "modelo": "grok-imagine-image-2-0", "prompt": "Renderize isto como um esboço detalhado a lápis com sombreamento em hachuras cruzadas", "imagem": { "url": "https://example.com/photo.jpg" } }'

Para um compósito, envie o plural Imagens e referenciar cada um por índice:

{ "model": "grok-imagine-image-2-0", "prompt": "Coloque o produto <IMAGE_0> de sobre a superfície de mármore <IMAGE_1>em ", "imagens": [ { "URL": "https://example.com/product.png" }, { "URL": "https://example.com/counter.jpg" } ] }

Qualidade e resolução

Dois controles independentes moldam a saída. Qualidade é baixo ou Médio, e resolução é 1k ou 2k. Eles se combinam em quatro pontos operacionais, então você pode escolher o que se encaixa no trabalho em vez de pagar tarifas principais por uma miniatura.

aspect_ratio cobre quatorze proporções de 1:1 através 20:9, mais Auto, que permite ao modelo escolher a forma que se adequa ao prompt. Em uma edição, Auto segue a primeira imagem fonte.

Três coisas que valem a pena saber

  • Qualidade é um controle de latência, não apenas um controle de qualidade. A baixa qualidade volta em poucos segundos. Médio demora bem mais, especialmente em 2K. Se você está gerando dentro de um loop voltado para o usuário, baixo geralmente é o padrão certo e médio é a atualização deliberada.
  • Uma edição cobra suas imagens de origem. Cada imagem que você anexa carrega uma carga por imagem sobre a imagem de saída, na mesma taxa que todo modelo xAI em EmpirioLabs cobra por uma imagem de origem, então um composto de três imagens custa significativamente mais do que uma geração simples. A versão text-to-image não tem carga nenhuma de imagem de origem.
  • Seus links de imagem não expiram no cronograma de outra pessoa. As próprias URLs de saída do provedor são de curta duração. EmpirioLabs rehospeda cada imagem gerada em suas próprias URLs de mídia assinadas antes de retorná-las, então o que você recebe de volta é um link que pode armazenar e servir.

Limites

  • Até 3 imagens de origem por edição
  • Até 10 imagens de saída por requisição
  • Solicita até 8.000 caracteres
  • Imagens geradas passam por uma verificação automática de segurança de conteúdo antes de serem retornadas
  • Uma imagem produzida e depois bloqueada pela política de conteúdo ainda é cobrada, porque o xAI cobra pela geração mesmo quando sua própria verificação de segurança bloqueia a saída

Preços

O Grok Imagine Image 2.0 é pago conforme você usa, faturado por imagem de saída na qualidade e resolução que você selecionou, além de uma cobrança por imagem para cada imagem de origem em uma edição. Não há assinatura nem mínimo de crédito. O cartão de tarifas ao vivo está no página do modelo e em frente Preços, que sempre refletem as taxas atuais.

Comece a construir

Experimenta-o na Área de reprodução, leia a referência completa do parâmetro no Documentos de API, ou navegar pelo restante do catálogo na Página de modelos. Uma chave API cobre todos os modelos em EmpirioLabs.

Pronto para usar endpoints melhores?

Explore nossos modelos ou entre em contato conosco para consultas de negócios, implantações personalizadas ou qualquer outra coisa.