OpenAI: GPT Image 1

GPT Image 1 создаёт и редактирует изображения по тексту и визуальным входным данным, включая композиции по референсам и изменения по маске. Он поддерживает выбираемую точность входных изображений, стандартные размеры кадра, прозрачный фон и вывод в PNG, JPEG или WebP.

Ailoot Ultra · Картинки POST /v1/images/generations openai/gpt-image-1

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

GPT Image 1 — изначально мультимодальная модель OpenAI для изображений, которая принимает текст и изображения и выдаёт изображения. Она может создать новую сцену, использовать референсы для построения композиции или отредактировать существующий материал по новой инструкции. Практические задачи включают иллюстрации, изображения продуктов, дизайн-концепции и локальные правки по маске. Это версия с названием GPT Image 1, отдельная от Image 1 Mini, Image 1.5 и более поздних версий GPT Image.

Подготовьте задание с объектом, обстановкой, композицией, освещением и визуальным стилем. Если нужен видимый текст, включите точную формулировку и объясните её предполагаемую иерархию и положение. Для композиции по референсам назначьте каждому изображению ясную роль, например продукт, окружение или визуальное оформление. Прямые процессы генерации и редактирования допускают запрос до 32,000 символов и от одного до десяти изображений на выходе. Сравните возвращённые вариации с одним и тем же заданием и сохраните выбранный материал для последующей работы.

Редактирование может принимать до шестнадцати изображений-референсов. GPT Image 1 поддерживает input_fidelity low и high, по умолчанию — low. Эта настройка влияет на усилия по сохранению особенностей и стиля исходного изображения; она отделена от качества отрисовки и размера результата. Правка с высокой точностью полезна, когда важны исходные детали, но не гарантирует, что каждая узнаваемая деталь останется идентичной. Указывайте, что нужно сохранить и что можно изменить, вместо того чтобы полагаться только на настройку точности.

Редактирование по маске обозначает область изменения. Согласно требованиям руководства, подготовьте исходник и маску в одинаковом формате и с одинаковыми размерами; каждый файл должен быть менее 50 MB, а маска должна содержать альфа-канал. При нескольких исходных изображениях маска применяется к первому. Полезное задание на правку может запросить другой цвет стены при сохранении мебели, ракурса камеры и освещения. Модель использует маску как ориентир, а не обещает точную границу, поэтому проверяйте и изменённую область, и её окружение.

Документированные стандартные размеры результата — 1024 × 1024, 1536 × 1024 и 1024 × 1536 пикселей, с автоматическим выбором размера там, где он поддерживается. Качество — low, medium, high или auto. GPT Image 1 использует эти стандартные кадры и уровни качества вплоть до high. Подбирайте стандартный кадр под предполагаемый показ, а уровень детализации — под назначение материала.

По умолчанию используется PNG; альтернативы — JPEG и WebP. Для JPEG и WebP доступно сжатие от 0 до 100. Прозрачный, непрозрачный и автоматический фон поддерживают разные потребности выдачи; для прозрачности необходим PNG или WebP. Для отдельного графического элемента используйте формат, сохраняющий альфа-канал, прежде чем помещать его в последующий макет. Для полной сцены включайте в задание фон и связь объекта с ним.

OpenAI документирует прямую генерацию и редактирование; карточка модели также включает использование изображений в диалоге. Для последовательной работы сохраняйте выбранный результат как исходник следующей правки, не выбирая неявно другую вариацию. Справочник изображений документирует потоковую передачу с выдачей до трёх промежуточных изображений; они показывают ход работы, а не дополнительные готовые материалы. Храните завершённое изображение и задание вместе, чтобы последующие правки ссылались на реальную композицию. Интерфейс производителя также поддерживает пакетную обработку.

Модель всё ещё может испытывать трудности с точным размещением текста, жёстко структурированными макетами и согласованностью повторяющихся объектов. Проверяйте надписи, границы предметов, цветовую обработку и детали, определяющие исходный материал, в предполагаемом размере. Если правку нужно доработать, опишите видимое несоответствие и сохраняемые элементы. GPT Image 1 полезен для конкретной последовательности генерации, редактирования по референсам и подготовки материала, при этом его собственные стандартные размеры и выбираемая точность входа должны оставаться отдельными от других версий.

Ailoot Ultra · Картинки POST /v1/images/generations openai/gpt-image-1

openai/gpt-image-1

OpenAI /openai/gpt-image-1

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Картинки POST /v1/images/generations

Входные данные: text, image
Результат: image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения openai/gpt-image-1	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1:1, 3:2, 2:3, auto	По умолчанию—
Поле`quality`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения auto, low, medium, high	По умолчанию—
Поле`background`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения auto, transparent, opaque	По умолчанию—
Поле`n`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 10	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Минимум элементов: 0 Максимум элементов: 16	По умолчанию—
Поле`output_compression`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 0 Максимум: 100	По умолчанию—
Поле`provider`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt
Параметр`material_types`	Контрактtext, image

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.32768 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Картинки

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Картинки

Загрузите каждое полученное изображение или сохраните его содержимое Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Чтение другого содержимого

Читать существующие материалы, принадлежащие вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.

Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа

Поле	Тип
Поле`created`	Тип
Поле`data[].url`	Тип
Поле`data[].b64_json`	Тип
Поле`usage`	Тип

Псевдонимы

Псевдонимы моделей

Ailoot Ultra openai/gpt-image-1

Псевдонимы путей метода

/v1/images

Связанные ID для вызова

openai/gpt-image-1

FAQ · OpenAI: GPT Image 1

Какие входные данные и результаты доступны?: POST /v1/images/generations · openai/gpt-image-1: text, image → image
Какие поля использует запрос?: POST /v1/images/generations · openai/gpt-image-1: model, prompt, aspect_ratio, quality, background, n, input_references, output_compression, provider
Какие ограничения действуют?: POST /v1/images/generations · openai/gpt-image-1: n.minimum: 1; n.maximum: 10; output_compression.minimum: 0; output_compression.maximum: 100

OpenAI: GPT Image 1