Skip to main content
POST
Este endpoint também aceita o alias grok-imagine-1.5-ext, equivalente a grok-imagine-1.5-apimart e intercambiável.

Authorizations

string
obrigatório
Todas as APIs exigem autenticação Bearer TokenObter API Key:Visite a página de gerenciamento de API KeyAdicione no cabeçalho da requisição:

Body

string
padrão:"grok-imagine-1.5-apimart"
obrigatório
Nome do modelo de geração de imagensModelos suportados:
  • grok-imagine-1.5-apimart - geração e edição de imagens Grok (alias grok-imagine-1.5-ext)
Exemplo:"grok-imagine-1.5-ext"
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para geração ou edição de imagem
string[]
Lista de URLs de imagens de referência. Omitir para text-to-image; incluir para edição.
  • Este modelo aceita de 1 a 5 imagens de referência
  • Aceita apenas URLs absolutas http:// ou https:// acessíveis publicamente
  • Envie imagens locais primeiro com POST /v1/uploads/images e use a url retornada
string
padrão:"1:1"
Tamanho da imagem de saídaFormatos suportados:
  • 1:1 - Quadrado (padrão)
  • 16:9 - Paisagem widescreen
  • 9:16 - Retrato
  • 3:2 - Paisagem
  • 2:3 - Retrato
integer
padrão:1
Número de imagens a gerarIntervalo: 1-10 (mínimo 1, máximo 10)⚠️ Atenção: deve ser um número puro (ex.: 1), sem aspas, senão ocorre erro

Response

integer
Código de status da resposta
array
Array de dados da resposta

Casos de uso

Caso 1: Text-to-Image

Caso 2: Text-to-Image (tamanho e quantidade)

Caso 3: Edição de imagem (fundo)

Caso 4: Edição de imagem (estilo)

Modelos oficiais

grok-imagine-image e grok-imagine-image-quality usam o mesmo fluxo assíncrono dos demais modelos de imagem. Após o envio, use o ID retornado e consulte o status da tarefa até concluir ou falhar.
Não envie quality. Sem image_urls, ocorre texto para imagem; uma imagem ativa edição e várias imagens fornecem múltiplas referências.

Parâmetros da solicitação

Valores de aspect_ratio: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto.

Resposta de criação da tarefa

202
Use data.id ou data.poll_url até o status ser completed ou failed.