Skip to main content
POST
Используйте этот маршрут для создания изображений из текста с помощью моделей изображений Grok. Тело запроса использует application/json. Запрос поддерживает model, prompt, n, aspect_ratio, resolution и response_format.

​
Выбор модели

Выберите ID модели изображений Grok на странице моделей. В примерах API используется grok-imagine-image-quality.

​
Настройка вывода

  • Используйте aspect_ratio, чтобы выбрать формат вывода, или auto, чтобы предоставить модели выбрать формат.
  • Используйте resolution, чтобы запросить вывод в формате 1k или 2k.
  • Используйте n, чтобы запросить до 10 изображений.
  • Используйте response_format, чтобы вернуть временные URL-адреса или данные изображений в кодировке Base64.
Подробные сведения о параметрах провайдера см. в руководстве по генерации изображений xAI.
Скачайте результаты по URL после завершения запроса. URL-адреса сгенерированных изображений могут истечь.

Авторизации

​
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-quality"

​
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>

The requested output resolution.

Доступные опции:
1k,
2k
Пример:

"1k"

​
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
обязательно

Usage details for the request.