GPT Image
GPT Image — семейство моделей для генерации и редактирования изображений через CDNvideo AI Hub media API.
Base URL
https://api.cdnvideo.ru/app/aihub-router/v1/media
Модель передаётся в заголовке X-Model:
X-Model: gpt-image-2
Генерация изображений
POST /images/generations
Метод генерирует изображения по текстовому описанию.
Параметры запроса
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
prompt |
string |
Да | Текстовое описание желаемого изображения. |
background |
string |
Нет | Поведение фона. Возможные значения: transparent, opaque, auto. Для gpt-image-2 прозрачный фон может не поддерживаться. |
moderation |
string |
Нет | Уровень модерации контента. Возможные значения: low, auto. |
n |
integer |
Нет | Количество генерируемых изображений. По умолчанию: 1. |
output_compression |
number |
Нет | Уровень сжатия для jpeg или webp от 0 до 100. Не применяется к png. |
output_format |
string |
Нет | Формат результата. Возможные значения: png, jpeg, webp. |
quality |
string |
Нет | Качество результата. Возможные значения: low, medium, high, auto. |
size |
string |
Нет | Размер изображения. Возможные значения: auto, 1024x1024, 1536x1024, 1024x1536. |
stream |
boolean |
Нет | Возвращать результат в streaming-режиме. По умолчанию: false. |
partial_images |
number |
Нет | Только для streaming-режима. Количество промежуточных изображений от 0 до 3. |
user |
string |
Нет | Уникальный идентификатор конечного пользователя для мониторинга и защиты от злоупотреблений. |
Пример curl
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/images/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: gpt-image-2" \
-d '{
"prompt": "A beautiful sunset over mountains with vibrant colors",
"quality": "high",
"size": "1024x1024",
"n": 1
}'
Пример OpenAI SDK
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIHUB_API_KEY"],
base_url="https://api.cdnvideo.ru/app/aihub-router/v1/media",
)
image = client.images.generate(
prompt="A beautiful sunset over mountains with vibrant colors",
quality="high",
size="1024x1024",
n=1,
extra_headers={"X-Model": "gpt-image-2"},
)
Пример с прозрачным фоном
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/images/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: gpt-image-2" \
-d '{
"prompt": "A cute cat sitting, isolated on transparent background",
"background": "transparent",
"output_format": "png"
}'
Прозрачный фон
Прозрачный фон может поддерживаться не всеми моделями GPT Image. Если модель не поддерживает background: transparent, используйте opaque или auto.
Пример streaming-режима
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/images/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: gpt-image-2" \
-d '{
"prompt": "A futuristic cityscape at night",
"stream": true,
"partial_images": 2
}'
Редактирование изображений
POST /images/edits
Метод редактирует или расширяет существующие изображения по текстовому описанию.
Параметры запроса
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
image |
array<File> |
Да | Загружаемые изображения. Формат: jpg или png, размер каждого файла — до 50MB. |
prompt |
string |
Да | Текстовое описание желаемого изменения. |
input_fidelity |
string |
Нет | Степень сохранения исходного изображения. Возможные значения: high, low. |
mask |
file |
Нет | PNG-маска области редактирования, размер — до 4MB. |
n |
number |
Нет | Количество генерируемых вариантов. |
partial_images |
number |
Нет | Только для streaming-режима. Количество промежуточных изображений от 0 до 3. |
quality |
string |
Нет | Качество результата. Возможные значения: low, medium, high, auto. |
size |
string |
Нет | Размер результата. Возможные значения: auto, 1024x1024, 1536x1024, 1024x1536. |
stream |
boolean |
Нет | Возвращать результат в streaming-режиме. По умолчанию: false. |
user |
string |
Нет | Уникальный идентификатор конечного пользователя. |
Пример curl
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/images/edits \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "X-Model: gpt-image-2" \
-F "image[]=@input.png" \
-F "prompt=Add a bright blue sky and make the image more cinematic" \
-F "quality=high" \
-F "size=1024x1024"
Формат ответа
Обычный ответ
{
"created": 1709312456,
"background": "opaque",
"output_format": "png",
"quality": "high",
"size": "1024x1024",
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
],
"usage": {
"input_tokens": 1250,
"input_tokens_details": {
"image_tokens": 1100,
"text_tokens": 150
},
"output_tokens": 4096,
"output_tokens_details": {
"image_tokens": 4000,
"text_tokens": 96
},
"total_tokens": 5346
}
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
created |
number |
Unix timestamp создания изображения в секундах. |
background |
string |
Использованный фон: transparent или opaque. |
output_format |
string |
Формат результата: png, webp или jpeg. |
quality |
string |
Качество результата: low, medium, high или auto. |
size |
string |
Размер результата. |
data |
array |
Список сгенерированных изображений. |
data[].b64_json |
string |
Изображение в формате Base64. |
usage |
object |
Информация об использованных токенах. |
usage.input_tokens |
number |
Количество входных токенов. |
usage.output_tokens |
number |
Количество выходных токенов. |
usage.total_tokens |
number |
Общее количество токенов. |
Streaming-ответ
event: image_generation.partial_image
data: {
"type": "image_generation.partial_image",
"partial_image_index": 0,
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
event: image_generation.completed
data: {
"type": "image_generation.completed",
"created": 1709312456,
"usage": {
"input_tokens": 1250,
"output_tokens": 4096,
"total_tokens": 5346
}
}
data: [DONE]
| Событие | Описание |
|---|---|
image_generation.partial_image |
Промежуточное изображение. Индекс передаётся в partial_image_index. |
image_generation.completed |
Генерация завершена, возвращается финальная информация об использовании. |
image_edit.partial_image |
Промежуточное изображение для редактирования. |
image_edit.completed |
Редактирование завершено. |
Ошибки
{
"error": {
"code": "invalid_api_key",
"message": "Incorrect API key provided",
"type": "invalid_request_error"
}
}
| Код | Описание |
|---|---|
invalid_api_key |
Некорректный API-key. |
invalid_request_error |
Ошибка в параметрах запроса. |
rate_limit_exceeded |
Превышен лимит запросов. |
content_policy_violation |
Контент нарушает правила безопасности. |
server_error |
Внутренняя ошибка сервера. |
Поддерживаемые размеры
| Размер | Соотношение сторон |
|---|---|
auto |
Автоматически |
1024x1024 |
1:1 |
1536x1024 |
3:2 |
1024x1536 |
2:3 |