Общая документация Public API · API-ключ можно создать в настройках аккаунта
GPT Image 2 создаёт изображения по текстовому заданию и может использовать загруженные изображения как референсы или исходник для редактирования.
POST /api/operations/create
В toolSlug передавайте gpt-image-2. Данные формы передаются в input по публичному контракту ниже.
{
"toolSlug": "gpt-image-2",
"input": {
"input": {
"quality": "medium",
"prompt": "A ginger cat sitting on a windowsill watching the sunset, watercolor style",
"image_urls": ["https://example.com/reference.png"],
"size": "16:9",
"resolution": "4k"
}
}
}
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
input.quality | string | да | Качество: low, medium, high. low выполняется через APIMart, medium и high — через Wavespeed. |
input.prompt | string | да | Задание для генерации или редактирования. Максимум 20000 символов. |
input.image_urls | string[] | нет | Изображения для редактирования или референсов. До 16 файлов: JPG, PNG, WebP, HEIC, HEIF. |
input.size | string | да | Соотношение сторон: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 2:1, 1:2, 21:9, 9:21. |
input.resolution | string | да | Разрешение результата: 1k, 2k, 4k. |
quality = "low" создаёт операцию в gpt-image-2 и собирает APIMart body.quality = "medium" или "high" автоматически создаёт операцию в hidden executor gpt-image-2-ws.input.image_urls используется text-to-image, с изображениями — edit.| Качество | 1K | 2K | 4K |
|---|---|---|---|
low | 2 ₽ | 3 ₽ | 4 ₽ |
medium | 10 ₽ | 18 ₽ | 26 ₽ |
high | 30 ₽ | 60 ₽ | 90 ₽ |
Результат операции возвращается в стандартном формате платформы:
{
"type": "image",
"urls": ["https://storage.yandexcloud.net/.../result.png"]
}