Справочник API
Image Generations
Генерация изображений
POST
/v1/images/generationsСоздаёт изображение по текстовому описанию.
Что указать
- модель;
- описание изображения;
- размер и другие параметры, если их поддерживает модель.
Доступность параметров зависит от конкретной модели. Если запрос возвращает ошибку валидации, проверьте документацию выбранной модели и доступность этой возможности в тарифе.
Пример запроса
curl {{PUBLIC_API_BASE_URL}}/images/generations \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"model": "provider/image-model",
"prompt": "Минималистичная иллюстрация панели аналитики",
"size": "1024x1024"
}'Параметры тела запроса
| Поле | Обязательность | Описание |
|---|---|---|
model | Да | Публичное имя модели изображений. |
prompt | Да | Описание изображения. |
size | Нет | Размер, если поддерживается моделью. |
n | Нет | Количество изображений. |
response_format | Нет | Формат ответа, если поддерживается. |
Поля ответа
| Поле | Обязательность | Описание |
|---|---|---|
created | Нет | Время создания. |
data | Да | Массив изображений. |
data[].url | Нет | Ссылка на изображение, если модель возвращает URL. |
data[].b64_json | Нет | Изображение в base64, если выбран такой формат. |
data[].revised_prompt | Нет | Уточнённый prompt, если модель его возвращает. |
Пример ответа
{
"created": 1760000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}