Grok Imagine 1.0 Image API: gere imagens com IA

O que é o Grok Imagine Image?

O Grok Imagine Image é a rota de geração de imagens focada em velocidade do modelo Grok Imagine, do xAI. Um único endpoint cobre texto para imagem e edições guiadas por referência: omita image_urls e o modelo gera só a partir do prompt, ou envie de 1 a 5 URLs de referência e o mesmo modelo entra no modo de edição, ancorado nesses visuais. A saída cobre cinco proporções de tela (1:1, 2:3, 3:2, 9:16, 16:9). Para uma saída focada em qualidade, selecione o modelo separado xai/grok-imagine-2.0-image. O antigo parâmetro enable_pro não é mais suportado.

Principais recursos do Grok Imagine Image

Cinco recursos cobrem o que você vai usar em um fluxo real de produção.

Texto para imagem e edição com referência no mesmo endpoint

Deixe image_urls de fora para gerar do zero a partir do texto. Envie de 1 a 5 referências e a mesma chamada muda para o modo de edição. Sem roteamento condicional no código do cliente, sem um segundo ID de modelo para gerenciar.

Iteração focada em velocidade

Use xai/grok-imagine-image para rascunhos rápidos e exploração criativa ágil. A qualidade agora é escolhida com o modelo separado Grok Imagine 2.0 Image, e não com uma opção na requisição.

Um modelo de qualidade separado

Leve as gerações de qualidade final para xai/grok-imagine-2.0-image. Os dois IDs de modelo suportam texto para imagem e edição com referência, então adicionar referências nunca muda o nível de qualidade escolhido.

Até 5 referências por chamada de edição

O modo de edição aceita de 1 a 5 imagens de referência para combinar sujeitos, transferir um estilo ou montar uma cena. Fixe a geometria do produto enquanto alterna fundo ou paleta entre gerações, ou mantenha a identidade de um personagem ao longo de uma campanha.

Cinco proporções de tela iguais às do Grok Imagine para vídeo

1:1, 2:3, 3:2, 9:16 e 16:9. O mesmo conjunto do modelo de vídeo, então uma imagem testada em 9:16 vira um vídeo vertical sem reescrever o prompt para cada proporção.

Para que serve o Grok Imagine Image

Um endpoint, dois fluxos
Texto para imagem e edição com referência rodam na mesma chamada. A presença de image_urls troca o fluxo sem roteamento condicional no seu cliente.
Produção em duas etapas
Faça rascunhos rápidos com xai/grok-imagine-image e depois envie o prompt vencedor para xai/grok-imagine-2.0-image na etapa de qualidade.
Variações de cor com várias referências
Até 5 referências por chamada permitem fixar a geometria do produto enquanto você alterna fundo ou paleta entre gerações. Útil para páginas de catálogo.
Exploração rápida de conceitos
Use o modelo de velocidade para testar composições, paletas e combinações de referências antes de partir para uma renderização final no 2.0.
Formatos para várias redes sociais
O mesmo prompt em 1:1, 9:16 e 16:9 gera um conjunto coerente sem reescrever o prompt para cada proporção. Combine com o modelo de vídeo Grok Imagine para ter imagens e vídeos consistentes.
Fluxos NSFW em contas autorizadas
Um único parâmetro enable_nsfw cuida do controle de política sem integração extra. Útil para pipelines moderados de conteúdo adulto que precisam de um único provedor suportado.

Escolha do modelo

Velocidade e qualidade são modelos separados. O enable_pro foi removido.

Velocidade

Use xai/grok-imagine-image para brainstorming, rascunhos em lote e iteração rápida.

Qualidade

Use xai/grok-imagine-2.0-image para ter a qualidade do Grok Imagine 2.0. Ele aceita as mesmas entradas de prompt, proporção de tela e imagens de referência.

Texto para imagem

Omita image_urls. O modelo gera só a partir do prompt. Bom para criar conceitos novos quando ainda não existe nenhuma referência.

Edição guiada por referência

Envie de 1 a 5 referências via image_urls. A chamada muda para o modo de edição, ancora o resultado nesses visuais e retorna uma única imagem. Útil para fotografia de produto, continuidade de personagem e troca de fundo.

Casos de uso do Grok Imagine Image

Faça um ciclo de brainstorming com xai/grok-imagine-image em 1:1 para escolher a composição principal e depois gere de novo a vencedora com xai/grok-imagine-2.0-image para o arquivo final de entrega. Monte uma folha de variações de cor enviando uma foto simples do produto como referência; as referências ativam o modo de edição sem mudar o modelo escolhido. Dê unidade a uma campanha com até 5 referências por chamada para que paleta, geometria e objetos de cena fiquem consistentes em todas as peças.

Exemplos da API do Grok Imagine Image

Chame o Grok Imagine Image a partir de qualquer linguagem com um POST para /v1/tasks. A documentação completa dos parâmetros está em docs.unifically.com/models/image/xai/grok-imagine-image.

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-image",
    "input": {
      "prompt": "A robot dancing in a field of sunflowers",
      "aspect_ratio": "16:9"
    }
  }'

Um envio bem-sucedido retorna um task_id. Consulte GET /v1/tasks/<task_id> ou defina um callback_url na requisição para receber as URLs das imagens prontas.

Perguntas frequentes

Perguntas frequentes sobre Grok Imagine 1.0 Image

O Grok Imagine Image é a rota de imagem do modelo Grok Imagine, do xAI. Um único endpoint cobre texto para imagem (quando você omite as referências) e edições guiadas por referência (quando você envia de 1 a 5 imagens de referência). O modo de edição retorna uma imagem por chamada.

As referências são opcionais. Deixe image_urls de fora para texto para imagem puro. Envie de 1 a 5 URLs e a chamada muda para o modo de edição, com o modelo ancorando o resultado nesses visuais. Ele combina sujeitos, transfere estilos e monta uma cena a partir das referências, por isso funciona bem para fotografia de produto, continuidade de personagem e troca de fundo.

Use o modelo separado xai/grok-imagine-2.0-image. O antigo parâmetro enable_pro foi removido; este ID de modelo continua sendo a opção focada em velocidade.

Para trabalhos com muita tipografia em que a qualidade é prioridade, selecione xai/grok-imagine-2.0-image. Use este modelo de velocidade para rascunhos rápidos e iteração.

Defina upsample_prompt como true e a API reescreve o seu prompt de texto antes da amostragem, expandindo briefings curtos ou vagos em uma descrição mais completa. Desative quando quiser que o modelo use o seu prompt exatamente como foi escrito.

Cinco: 1:1, 2:3, 3:2, 9:16 e 16:9. São as mesmas cinco proporções do Grok Imagine para vídeo, então a mesma composição pode ser testada como imagem e animada como vídeo sem reescrever o prompt para cada proporção.

Somente em contas com essa política habilitada. Envie enable_nsfw: true na chamada e, se a conta tiver permissão, o resultado ignora o filtro safe-for-work. Sem o parâmetro, os resultados continuam safe-for-work.

O modo de edição (quando image_urls é enviado como entrada) retorna um único image_url. O modo de texto para imagem retorna uma ou mais imagens em image_urls.

Ver todos os modelos

Ver todos os modelos →

API do Grok Imagine Image