Перейти к содержимому
Cheapest Imagen
Справочник API

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

Создаёт одно или несколько изображений по текстовому промпту. Кредиты резервируются при старте запроса и возвращаются за каждое недоставленное изображение.

POST
/images/generations

Создаёт одно или несколько изображений по текстовому промпту. Кредиты резервируются при старте запроса и возвращаются за каждое недоставленное изображение.

Authorization

apiKey
headerAuthorizationBearer <token>

Ваш API-ключ, передаётся как Authorization: Bearer <key>.

Header Parameters

Idempotency-Key?string

Значение на ваш выбор, до 255 символов. Повторная отправка того же значения не создаёт и не оплачивает второй запрос, а возвращает 409.

Lengthlength <= 255

Request Body

application/json
  1. body
model*string

Используемая модель.

Value in"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"
prompt*string

Что должно быть на изображении. До 32 000 символов.

Lengthlength <= 32000
n?integer

Сколько изображений создать. Запрос расходует n раз по стоимости модели в кредитах. Не более 10 в 1K, 4 в 2K и 2 в 4K.

Range1 <= value <= 10
Default1
size?string

auto — модель выбирает сама (у модели с одним разрешением — это разрешение). Остальные значения — размеры 1K, 2K и 4K; каждая модель принимает разрешения, указанные на её карточке на /ru/models, по одной цене. Соотношения сторон смотрите в руководстве по размерам. gpt-image-2-adobe и gpt-image-2.5-flare принимают также свои ширину и высоту: кратные 16, до 3840 px по стороне, не более 3:1, от 655 360 до 8 294 400 пикселей.

Default"auto"
Value in"auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"
quality?string

Качество отрисовки; учитывают gpt-image-2-adobe и варианты flare и sunburst, остальные модели GPT выбирают его сами, а Nano Banana его игнорирует. xhigh и max работают только в gpt-image-2.5-sunburst. Любое качество стоит одинаково.

Default"auto"
Value in"auto""low""medium""high""xhigh""max"
background?string

Сейчас ни одна модель не делает прозрачный фон, поэтому transparent возвращает ошибку 400. auto и opaque работают на всех моделях.

Default"auto"
Value in"auto""opaque"
output_format?string

Формат файла возвращаемых изображений. gif работает на gpt-image-2.6 и её вариантах flare и sunburst, svg — только на gpt-image-2.6. png, jpeg и webp работают на всех моделях.

Default"png"
Value in"png""jpeg""webp""gif""svg"
output_compression?integer

Качество для jpeg и webp, от 0 до 100. По умолчанию 100.

Range0 <= value <= 100
moderation?string

Насколько строго проверяются промпт и результат. low — менее строгая проверка.

Default"auto"
Value in"auto""low"
response_format?string

b64_json возвращает данные изображения в ответе. url возвращает ссылку на изображение, которая хранится 72 часа.

Default"b64_json"
Value in"b64_json""url"
async?boolean

Значение true запускает запрос в фоне. В ответ сразу приходит 202 с задачей; результат читайте позже через GET /images/tasks/{id}. Изображения возвращаются ссылками, поэтому response_format должен быть url или быть опущен. Заголовок Prefer: respond-async делает то же самое.

Defaultfalse
webhook_url?string

С async: адрес https://, на который придёт один POST с готовой задачей (тот же JSON, что у GET /images/tasks/{id}). Делается до 3 попыток. Передайте webhook_secret, чтобы вызов был подписан; без него проверяйте полученное, запросив задачу своим ключом.

Formaturi
webhook_secret?string

С webhook_url: ваш собственный секрет, от 16 до 128 символов. Тогда вызов вашего адреса содержит x-webhook-signature: t=<unix seconds>,v1=<hex>, где hex — это HMAC-SHA256 от <t>.<body> с этим секретом.

Length16 <= length <= 128

Response Body

Изображения.

application/json
  1. response
created*integer

Когда созданы изображения, в виде Unix-времени в секундах.

data*array<>
Example Request
curl -X POST 'https://api.cheapestimagen.com/v1/images/generations' \  -H 'Content-Type: application/json' \  -d '{  "model": "gpt-image-2",  "prompt": "a red fox in the snow",  "size": "1536x1024"}'
Example Response
{  "created": 0,  "data": [    {      "b64_json": "string",      "url": "http://example.com"    }  ]}