Перейти к содержанию

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