Практическое руководство по промптам GPT Image 2 и учебник по API

В этом руководстве по использованию GPT Image 2 объясняется, как преобразовать визуальное описание проекта в запрос на контролируемую генерацию или редактирование и обработать его с помощью OdiRouter. Большее количество прилагательных редко помогает исправить слабый промпт. Определите, что должно быть на изображении, что должно остаться неизменным и по каким критериям вы будете оценивать результат.

OdiRouter предоставляет отдельные конечные точки очереди для генерации и редактирования. Используйте gpt-image-2, когда создаёте изображение по тексту. Используйте gpt-image-2-edit, когда одно или несколько референсных изображений должны влиять на результат.

Сначала выберите генерацию или редактирование

Выберите рабочий процесс, прежде чем приступать к доработке промпта.

Используйте GPT Image 2 generation endpoint для новой иллюстрации, предметной сцены, постера, диаграммы, материала для социальных сетей или концепт-изображения. Конечная точка OdiRouter:

/v1/queue/gpt-image-2

Используйте GPT Image 2 Edit endpoint, когда нужно сохранить или преобразовать существующее изображение. Редактирование лучше подходит для замены фона, ретуши продукта, изменений макета, стилевых референсов или серии, в которой должен сохраняться один и тот же объект.

/v1/queue/gpt-image-2-edit

Обе конечные точки используют асинхронную мультимодальную очередь OdiRouter. Запрос на отправку возвращает request_id, а также status_url, response_url и cancel_url. Ваше приложение опрашивает статус и получает ответ после того, как задание перейдёт в состояние завершения.

Пишите промпты как производственные брифы

Относитесь к промпту как к производственному брифу. Сначала укажите цель и композицию, затем опишите стиль и детали поверхности. Завершите описание ограничениями.

Используйте такую структуру:

Goal: What the image will be used for.
Scene: Location, time, environment, and background.
Subject: The main person, object, or product.
Composition: Framing, camera angle, placement, and empty space.
Style: Photography, illustration, interface, diagram, or other medium.
Details: Lighting, materials, colors, typography, and texture.
Constraints: What must not change or appear.

Например:

Goal: A website hero image for an API tutorial.
Scene: Dark studio background with a subtle blue gradient.
Subject: A clean workstation showing an image-generation workflow.
Composition: Wide landscape frame, workstation on the right, empty space on the left for a headline.
Style: Photorealistic editorial technology photography.
Details: Soft rim light, restrained blue accents, realistic screen reflections, sharp hardware texture.
Constraints: No logos, no watermark, no unreadable interface text, no extra monitors.

Это управляет компоновкой, не пытаясь предписать каждый пиксель. Если первый результат близок к желаемому, внесите одно целенаправленное последующее изменение вместо полной замены всего технического задания.

Задавайте параметры изображения обдуманно.

В текущей версии OdiRouter допускается возврат одного запроса между образами 1 и 10. Установите значение n в пределах этого диапазона.

Выберите одно значение quality:

• low

• medium

• high

• auto

Выберите одно значение moderation:

• auto

• low.

Размер

Используйте auto, стандартный фиксированный размер, или пользовательское значение WIDTHxHEIGHT, соответствующее ограничениям модели. Распространённые фиксированные размеры:

• 1024x1024

• 1024x1536

• 1536x1024

• Оба ребра должны быть кратны 16;

• длина большей стороны не должна превышать 3840 пикселей;

• соотношение длинной и короткой сторон не должно превышать 3:1;

• общее количество пикселей должно составлять от 655,360 до 8,294,400.

Для квадратного чернового варианта начните с 1024x1024. Используйте 1536x1024 для горизонтального контента или 1024x1536 для вертикального контента. Более крупные варианты включают 2048x2048 и 2048x1152. OpenAI описывает результаты с разрешением выше 2K как экспериментальные, поэтому протестируйте свой рабочий процесс, прежде чем использовать 3840x2160 или 2160x3840 в продакшене.

Качество

Используйте low при проработке композиции, затем переходите на medium, когда выбранное направление будет выглядеть подходящим. Оставьте high для финальных материалов, которым требуется больше деталей или более чёткие мелкие элементы. Более высокие настройки могут увеличить время обработки и стоимость. Прежде чем повышать качество, уточните бриф.

Формат вывода и фон

В справочнике по генерации OdiRouter перечислены png и jpeg. В его справочнике по редактированию также указан webp. JPEG и WebP поддерживают output_compression; PNG не использует эту настройку.

GPT Image 2 в настоящее время не поддерживает прозрачный фон. Используйте auto или opaque для запросов на редактирование и предусмотрите отдельный этап удаления фона, если для вашего итогового материала требуется прозрачность.

Отправьте задание на генерацию через OdiRouter

Базовый URL для мультимодального API: https://api.odirouter.ai/model. Отправляйте API-ключ OdiRouter из серверной среды и никогда не раскрывайте его в коде браузера.

curl --location "https://api.odirouter.ai/model/v1/queue/gpt-image-2" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean product photo of a red ceramic mug on a light gray table, soft window light, three-quarter view, realistic texture, no logo, no text",
    "n": 1,
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "jpeg",
    "output_compression": 90,
    "moderation": "auto"
  }'

Успешный ответ на отправку содержит идентификаторы задачи:

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/gpt-image-2/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/gpt-image-2/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/gpt-image-2/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Сохраните request_id. Опрашивайте конечную точку статуса через разумные интервалы. Когда статус будет завершён и ошибок не будет, запросите response_url и сохраните возвращённый ресурс в формате, ожидаемом вашим приложением.

Редактируйте изображения, не теряя важные детали

Конечная точка редактирования принимает до 16 входных изображений. GPT Image 2 автоматически обрабатывает входные изображения с высокой точностью, поэтому задания на редактирование с большим количеством референсов могут использовать больше входных токенов, чем генерация только по тексту.

При внесении изменений укажите, что может измениться, а что должно остаться неизменным.

Change: Replace the background with a warm white studio wall and a pale stone surface.
Preserve: Product shape, label text, camera angle, crop, colors, reflections, and proportions.
Add: A soft shadow that matches the original light direction.
Do not add: New text, props, logos, hands, or decorative borders.

Пример запроса:

curl --location "https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "Replace only the background with a warm white studio setup. Preserve the product, label text, camera angle, crop, colors, and reflections. Add no new objects.",
    "images": ["https://example.com/product.png"],
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "background": "auto",
    "output_format": "png",
    "moderation": "auto"
  }'

Если вы предоставляете маску, она должна соответствовать формату и размерам отредактированного изображения и включать альфа-канал. Прозрачные области маски обозначают регионы, которые могут быть отредактированы. Воспринимайте маску как руководство и придерживайтесь тех же правил хранения, что и в письменном указании.

Шаблоны промптов для распространённых задач

Изображение продукта

Create a landscape product photograph of a matte black desk lamp on a walnut desk. Three-quarter camera angle, soft morning window light, realistic metal and wood texture, quiet home-office background. Leave clean space in the upper left for page copy. No logo, no text, no extra products.

Плакат с точным текстом

Create a vertical event poster with the exact headline "BUILD WITH IMAGES". Bold geometric sans-serif type, centered, high contrast, generous spacing. Dark navy background with one coral accent shape. Include the headline once. No other words, no logos, no watermark.

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

Концепция интерфейса

Design a desktop dashboard concept for an image-generation queue. Show a prompt panel, job status list, preview grid, and download action. Neutral light theme, accessible contrast, realistic spacing, no company logo. Use short readable labels and avoid decorative data.

Изменение стиля на основе референса

Use Image 1 as the composition source and Image 2 only as a color and texture reference. Preserve the subject, pose, framing, and background geometry from Image 1. Apply the muted paper texture and limited blue-gray palette from Image 2. Do not copy objects or text from Image 2.

Исправляйте слабые результаты небольшими изменениями

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

Увеличение quality не исправит неясное техническое задание. Это может улучшить рендеринг, но не сможет устранить противоречивые инструкции. Изменяйте по одной переменной за раз, чтобы понимать, какая правка помогла.

Также обрабатывайте сбои API отдельно от визуальных проблем. Перед повторной попыткой проверяйте статус HTTP, идентификатор запроса, статус задачи и возвращённую ошибку. Повторяйте попытки при временных ошибках сервиса или ограничениях частоты запросов, используя ограниченную задержку. Изменяйте промпт или входные данные, когда сервис сообщает об исправимой пользователем ошибке генерации изображения.

Начните с небольшого теста OdiRouter

Откройте OdiRouter quick start, создайте ключ API и отправьте генерацию quality: "low" на 1024x1024. Когда композиция будет готова, перейдите к GPT Image 2 model page, изучите точный справочник по генерации или редактированию и проверьте current OdiRouter pricing, прежде чем увеличивать разрешение или объём.

Это позволяет разделить работу над промптами, интеграцию API и решения о производственных затратах. Вы также получите воспроизводимый запрос до создания более масштабного процесса работы с изображениями.

Источники

• OdiRouter GPT Image 2 generation reference

• OdiRouter GPT Image 2 Edit reference

• OdiRouter quick start

• OpenAI GPT Image 2 model documentation

• OpenAI image generation guide