Skip to main content
POST
Використовуйте цей маршрут, щоб створювати зображення з тексту за допомогою моделей зображень Grok. Тіло запиту використовує application/json. model і prompt є обов’язковими.

​
Виберіть модель

Виберіть ідентифікатор моделі зображень Grok на сторінці моделей. У прикладах API використовується grok-imagine-image-2.0. quality доступна лише з grok-imagine-image-2.0 і приймає low або medium. Явно встановіть її, якщо ваш застосунок залежить від певного рівня якості. Якщо resolution не вказано для Image 2.0, CometAPI використовує 1k.

​
Налаштуйте вивід

  • Використовуйте aspect_ratio, щоб вибрати формат виводу, або auto, щоб модель вибрала формат.
  • Використовуйте resolution, щоб запитати вивід 1k або 2k.
  • Використовуйте n, щоб запитати від 1 до 10 зображень. Типове значення — 1.
  • Використовуйте response_format, щоб повертати тимчасові URL-адреси або дані зображень, закодовані в Base64.
Відомості про поведінку, специфічну для моделі, див. у посібнику xAI зі створення зображень.
Негайно завантажуйте результати за URL-адресами після завершення запиту. URL-адреси створених зображень є тимчасовими. Використовуйте b64_json, коли вашому застосунку потрібні байти зображення у відповіді API.

Авторизації

​
Authorization
string
header
обов'язково

Use your CometAPI API key as the bearer value.

Тіло

application/json
​
model
enum<string>
обов'язково

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

Доступні опції:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Приклад:

"grok-imagine-image-2.0"

​
prompt
string
обов'язково

A text description of the image to generate.

Minimum string length: 1
Приклад:

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

​
n
integer
за замовчуванням:1

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

Необхідний діапазон: 1 <= x <= 10
​
aspect_ratio
enum<string>

The output shape. Use auto to let the model select the 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
Приклад:

"16:9"

​
resolution
enum<string>
за замовчуванням:1k

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

Доступні опції:
1k,
2k
Приклад:

"1k"

​
quality
enum<string>

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

Доступні опції:
low,
medium
Приклад:

"low"

​
response_format
enum<string>
за замовчуванням:url

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

Доступні опції:
url,
b64_json

Відповідь

200 - application/json

The generated image results.

​
data
object[]
обов'язково

The generated images.

Minimum array length: 1
​
usage
object

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

Останнє оновлення 21 серпня 2026 р.