Skip to main content
POST
cURL

Модели изображений OpenAI

Редактируйте или расширяйте изображения на основе одного или нескольких исходных изображений и промптов. Поддерживаются модели gpt-image-1 и dall-e-2.
Поскольку редактирование изображений OpenAI является синхронным ответом и занимает много времени, рекомендуется использовать шлюз https://api.ttapi.org.

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json
prompt
string
обязательно

Текстовое описание изображения. Максимальная длина: gpt-image-1 поддерживает до 32 000 символов, dall-e-2 поддерживает до 1 000 символов, dall-e-3 поддерживает до 4 000 символов.

image
array
обязательно

Изображение для редактирования. Должен быть поддерживаемым файлом изображения или массивом изображений.
gpt-image-1: каждое изображение должно быть в формате PNG, WebP или jpg размером менее 25 МБ.
dall-e-2: вы можете предоставить только одно изображение, и это должен быть квадратный файл PNG размером менее 4 МБ.

mask
file

Дополнительное изображение, где полностью прозрачные области (например, нулевое значение альфа) указывают, где изображение следует редактировать. Если предоставлено несколько изображений, маска применяется к первому изображению. Должен быть действительный файл PNG размером менее 4 МБ и того же размера, что и изображение.

mode
enum<string>
по умолчанию:dall-e-2

Поддерживаемые модели

Доступные опции:
gpt-image-1,
dall-e-2
n
integer

Количество генерируемых изображений, по умолчанию 1.
Доступный диапазон 1-10

output_compression
integer
по умолчанию:100

Уровень сжатия создаваемых изображений (0-100%). Этот параметр применим только к gpt-image-1 с выходным форматом webp или jpeg, значение по умолчанию — 100.

quality
string
по умолчанию:auto

Качество изображения.
auto (по умолчанию) автоматически выбирает лучшее качество для данной модели.
gpt-image-1 поддерживает три качества: high, medium, low.
dall-e-3 поддерживает hd и standard.
dall-e-2 поддерживает только standard.

response_format
string

Формат возвращаемых данных.
dall-e-3 и dall-e-2 поддерживают url или b64_json. URL действительны в течение 60 минут, поэтому кэшируйте сразу после получения.
gpt-image-1 поддерживает только b64_json.

size
string
по умолчанию:auto

Размер изображения. Опции
gpt-image-1: 1024x1024, 1536x1024, 1024x1536, auto (по умолчанию). Варианты
dall-e-2: 256x256, 512x512, 1024x1024. Варианты
dall-e-3: 1024x1024, 1792x1024, 1024x1792.
Примечание. Разные размеры используют разные квоты TTAPI.

Ответ

Запрос успешен, возвращает результаты генерации изображения в формате Base64.

created
integer
обязательно

Временная метка генерации (секунды)

Пример:

1713833628

data
object[]
обязательно

Список результатов создания изображений

usage
object
обязательно

Использование токена (должен возвращаться для формата Base64)

Пример:
Последнее изменение 16 июня 2026 г.