GPT-Image-1.5
gpt-image-1-5
GPT-Image-1.5 — генерация изображений от OpenAI, доступная через единый Ranvik API. Поддерживаемые возможности: text_to_image.
от 2.52 ₽ / шт
Технические характеристики
gpt-image-1-5Возможности
- Text-to-image
Цены
| Единица | Цена |
|---|---|
| за изображение · low | 2.52 ₽ |
| за изображение · low · portrait | 3.64 ₽ |
| за изображение · low · landscape | 3.64 ₽ |
| за изображение · medium | 9.52 ₽ |
| за изображение | 11.2 ₽ |
| за изображение · medium · portrait | 14 ₽ |
| за изображение · medium · landscape | 14 ₽ |
| за изображение · high | 37.24 ₽ |
| за изображение · high · portrait | 56 ₽ |
| за изображение · high · landscape | 56 ₽ |
Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.
Поддерживаемые параметры
Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.
| Параметр | Тип | Диапазон / values | Default | Описание |
|---|---|---|---|---|
promptrequired | string | max: 32000 | — | Текстовое описание желаемого изображения. До 32k символов для GPT image моделей. примеры значенийПримеры Иллюстрация: голубой кит парит над городом среди звёзд, фантастический стиль. |
background | enum | transparent, opaque, auto | auto | Прозрачность фона. При transparent — output_format должен быть png или webp. |
moderation | enum | low, auto | auto | Уровень content-moderation: low — менее строгий, auto — стандарт. |
n | integer | min: 1 · max: 10 | 1 | Количество изображений за один запрос. |
output_compression | integer | min: 0 · max: 100 | 100 | Уровень сжатия (0-100%). Только для output_format=webp или jpeg. |
output_format | enum | png, jpeg, webp | — | Формат файла. png — поддерживает прозрачность. |
partial_images | integer | min: 0 · max: 3 | — | Количество partial images для streaming-режима. 0 — только финальное изображение. |
quality | enum | auto, high, medium, low | auto | Качество генерации. high — лучшее, low — быстрее и дешевле. |
size | enum | auto, 1024x1024, 1536x1024, 1024x1536 | auto | Размер изображения. auto — модель выбирает оптимально. |
stream | boolean | — | false | Streaming-режим. Управляется через partial_images. |
user | string | — | — | Уникальный идентификатор end-user — для abuse detection OpenAI. |
Поддерживаемые размеры
Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.
1024×10241536×10241024×1536Параметры ответа
Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}.
Sync (HTTP 200)
Sync-ответ (default). HTTP 200 + JSON.
| Поле | Тип | Значения | Описание |
|---|---|---|---|
created | integer | — | Unix timestamp когда сгенерировано. |
data | array | — | Каждый элемент:
|
provider | string | — | Вендор для отладки. |
Async (HTTP 202)
Если в запросе передан async:true → HTTP 202.
| Поле | Тип | Значения | Описание |
|---|---|---|---|
id | string | — | task_id для опроса через GET /v1/tasks/{id}. |
object | string | image.task | |
status | enum | queued, processing, completed, failed | |
model | string | — | Public model id. |
created | integer | — |
Опрос статуса (GET /v1/tasks/{id})
GET /v1/tasks/{id} — опрос статуса async-задачи.
| Поле | Тип | Значения | Описание |
|---|---|---|---|
id | string | — | |
object | string | task | |
status | enum | queued, processing, completed, failed, canceled | |
modality | string | image | |
model | string | — | |
created | integer | — | |
data | array | — | Каждый элемент:
|
error | string | — | Сообщение об ошибке (если failed). |
Пример запроса
from openai import OpenAI
client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.images.generate(
model= "gpt-image-1-5",
prompt= "Пример промпта",
background= "auto",
moderation= "auto",
n= 1,
output_compression= 100,
output_format= "png",
partial_images= 2,
quality= "auto",
size= "auto",
stream= False,
user= "value",
)
print(resp) Замените rk_live_... на ваш ключ из кабинета.
О провайдере: OpenAI
OpenAI — американская компания, создатель ChatGPT и серии моделей GPT. Один из лидеров индустрии генеративного ИИ. Модели OpenAI отличаются балансом скорости, качества и широкой поддержкой инструментов (function calling, vision, structured output).
Официальный сайт: https://openai.com
Документация модели у вендора: https://platform.openai.com/docs/api-reference/images