Skip to main content
POST
Use esta rota para criar imagens a partir de texto com modelos de imagem Grok. O corpo da solicitação usa application/json. model e prompt são obrigatórios.

​
Escolha um modelo

Escolha um ID de modelo de imagem Grok na página de Modelos. Os exemplos da API usam grok-imagine-image-2.0. quality está disponível apenas com grok-imagine-image-2.0 e aceita low ou medium. Defina-o explicitamente quando sua aplicação depender de um nível de qualidade específico. Quando resolution é omitido para o Image 2.0, a CometAPI usa 1k.

​
Configure a saída

  • Use aspect_ratio para selecionar o formato da saída ou auto para permitir que o modelo selecione o formato.
  • Use resolution para solicitar saída 1k ou 2k.
  • Use n para solicitar de 1 a 10 imagens. O padrão é 1.
  • Use response_format para retornar URLs temporárias ou dados de imagem codificados em Base64.
Para ver o comportamento específico do modelo, consulte o guia de geração de imagens da xAI.
Baixe os resultados de URL imediatamente após a conclusão da solicitação. As URLs de imagens geradas são temporárias. Use b64_json quando sua aplicação precisar dos bytes da imagem na resposta da API.

Autorizações

​
Authorization
string
header
obrigatório

Use your CometAPI API key as the bearer value.

Corpo

application/json
​
model
enum<string>
obrigatório

The Grok image model ID. See the Models page for available model IDs.

Opções disponíveis:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Exemplo:

"grok-imagine-image-2.0"

​
prompt
string
obrigatório

A text description of the image to generate.

Minimum string length: 1
Exemplo:

"A glass observatory above a quiet alpine lake at sunrise"

​
n
integer
padrão:1

The number of images to generate. Use an integer from 1 through 10.

Intervalo necessário: 1 <= x <= 10
​
aspect_ratio
enum<string>

The output shape. Use auto to let the model select the aspect ratio.

Opções disponíveis:
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
Exemplo:

"16:9"

​
resolution
enum<string>
padrão:1k

The requested output resolution. Image 2.0 uses 1k when this field is omitted.

Opções disponíveis:
1k,
2k
Exemplo:

"1k"

​
quality
enum<string>

Image quality for grok-imagine-image-2.0. This field is not available for the older Grok image model IDs.

Opções disponíveis:
low,
medium
Exemplo:

"low"

​
response_format
enum<string>
padrão:url

The image representation in each response item. Use url for a temporary download URL or b64_json for Base64-encoded image bytes.

Opções disponíveis:
url,
b64_json

Resposta

200 - application/json

The generated image results.

​
data
object[]
obrigatório

The generated images.

Minimum array length: 1
​
usage
object

Additional usage metadata returned for the request. Its contents can vary by model.

Última modificação em 21 de agosto de 2026