Создать изображение

Создание изображений Grok по текстовому запросу.

Этот API использует путь OpenAI Images Generations и поддерживает параметры Grok, такие как aspect_ratio и resolution.

POST/v1/images/generations

Создавайте одно или несколько изображений по текстовому запросу. Этот API использует endpoint POST /v1/images/generations в стиле OpenAI и добавляет параметры соотношения сторон и разрешения для моделей изображений Grok.

Примеры ID моделей: grok-imagine-image-pro и grok-imagine-image. Перед вызовом уточните фактически доступные ID в списке моделей текущего ключа API.

Один запрос создаёт не более 10 изображений; результаты с URL являются временными ссылками, поэтому своевременно скачивайте или обрабатывайте их; сгенерированный контент может фильтроваться политикой в отношении контента; выходные изображения обычно имеют формат JPG.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Параметры запроса на генерацию изображений Grok.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели для генерации изображений. Примеры моделей:

grok-imagine-image-pro: продвинутая модель изображений для высококачественных и детализированных сцен.
grok-imagine-image: универсальная модель генерации изображений.

Фактически доступные модели определяются списком, возвращаемым текущим ключом API.

Длина1 <= length

prompt*string

Текстовое описание желаемого изображения.

Длина1 <= length

n?integer

Количество генерируемых изображений: от 1 до 10.

Диапазон1 <= value <= 10

По умолчанию1

response_format?string

Формат возвращаемых изображений. url возвращает временный URL изображения, который следует как можно скорее скачать или обработать; b64_json возвращает данные изображения в Base64.

По умолчанию"url"

Допустимые значения

"url"
"b64_json"

aspect_ratio?string

Соотношение сторон генерируемого изображения. Если не передано, модель выбирает его автоматически. Примеры распространённых значений:

1:1
16:9, 9:16
4:3, 3:4
3:2, 2:3
2:1, 1:2
19.5:9, 9:19.5
20:9, 9:20
auto

Это распространённые примеры, а не ограничение закрытым набором значений enum.

resolution?string

Разрешение выходного изображения; поддерживаются 1k и 2k.

Допустимые значения

"1k"
"2k"

user?string

Уникальный идентификатор конечного пользователя для мониторинга и управления рисками.

Длина1 <= length

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A cat in a tree",    "n": 1,    "response_format": "url"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg"
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ]
}

Создать изображение

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`