Перейти к основному содержанию
POST
GPT-Image-2.6 официальный канал генерации изображений
Через официальный канал доступны две модели GPT-Image-2.6. Отправка запроса сразу возвращает ID асинхронной задачи. Изображения генерируются в фоне и сохраняются в R2 перед выдачей. В запросах нужно использовать полное имя модели из таблицы. gpt-image-2.6-official — это только название серии, его нельзя передавать в model. Пользователи в материковом Китае могут заменить https://api.toapis.com в примерах на https://api.toapis.cn. Создайте API Key в консоли и установите переменную окружения TOAPIS_API_KEY.

Отправка и опрос

Отправка изображения через Flare. Для Sunburst достаточно заменить model:
Сохраните id из ответа и подставьте его вместо TASK_ID ниже:
Ответ на отправку — pending. При опросе может отображаться queued или in_progress, финальные статусы — completed или failed. При completed URL результата, сохранённого в R2, находится в result.data[].url; при failed читайте error. Опрашивайте один и тот же ID задачи каждые несколько секунд; высококачественная генерация может занять несколько минут, не отправляйте запрос повторно во время ожидания. Все поля описаны в API статуса задачи изображения.

Параметры запроса

string
обязательно
API Key ToAPIs в формате Bearer YOUR_API_KEY.
string
обязательно
gpt-image-2.6-sunburst-official / gpt-image-2.6-flare-official.
string
обязательно
Описание изображения. При использовании референсных или разметочных изображений опишите, что сохранить и что изменить.
string
по умолчанию:"auto"
Имена соотношений сторон (например 1:1, 3:2, 2:3, 16:9, 9:16) или размеры в пикселях (например 1024x1024, 1536x1024). Для вывода GIF семантика size описана в разделе GIF. Обе стороны в пикселях должны быть кратны 16 и не меньше 16, каждая сторона — не более 3840, а отношение большей стороны к меньшей — не более 3:1; размеры свыше 2560x1440 считаются экспериментальными.
string
Уровень разрешения 1k / 2k / 4k. Явное значение имеет приоритет над уровнем, выведенным из size. Уровень влияет на фактическое потребление токенов и время генерации.
string
по умолчанию:"medium"
Шесть уровней: auto, low, medium, high, xhigh, max. auto позволяет модели выбирать уровень для каждого запроса. Качество влияет на фактическое потребление токенов и время.
integer
по умолчанию:1
От 1 до 4 изображений на запрос. При output_format = svg допустимо только 1.
string
Формат вывода png / jpeg / webp / gif / svg. Если не указан, используется формат по умолчанию на стороне провайдера. Дополнительные параметры и ограничения gif и svg описаны в соответствующих разделах.
integer
Степень сжатия 0-100, применяется только к выводу jpeg и webp.
string
transparent / opaque / auto. Явная прозрачность применяется только к png / webp; svg прозрачен по умолчанию.
string
Уровень модерации контента auto / low.
string
Сложность генерации low / medium / high; по умолчанию high. Отдельно не тарифицируется.

Референсные изображения и маски

Для генерации image-to-image добавьте image_urls в тот же JSON-запрос — до 16 изображений. URL должны быть доступны с сервера. Сначала можно получить URL через API загрузки изображений. Референсные изображения тарифицируются как входные токены изображений. mask_url указывает на PNG-маску с альфа-каналом; её размер должен совпадать с первым референсным изображением, и она используется только вместе с image_urls.

Редактирование по разметке

markup_url указывает на размеченное референсное изображение (либо передайте встроенный объект разметки через markup). Вместе с image_urls для исходного изображения модель редактирует по смыслу разметки. markup_url и mask_url взаимоисключающие — в одном запросе можно использовать только один из них.

Вывод GIF

Передайте gif в output_format, чтобы создать анимацию. frame_count задаёт число кадров (2-16), frame_duration_ms — длительность кадра. GIF поддерживает только text-to-image и не может сочетаться с image_urls, mask_url, markup_url, markup и output_compression. Передавайте size точным пиксельным значением (например 512x512) или опустите его, чтобы использовать размеры кадра по умолчанию от апстрима; соотношения вроде 1:1 для GIF отклоняются.

Вывод SVG

Передайте svg в output_format, чтобы создать векторное изображение. Также требуется объект svg с указанным svg.model. SVG поддерживает только text-to-image, n может быть только 1 и не может сочетаться с image_urls, mask_url, markup_url, markup и output_compression. SVG-генерация дополнительно вызывает текстовую модель, указанную в svg.model, и тарифицируется по её ставке.

Цены на токены

Обе официальные модели тарифицируются по категориям токенов: текстовый ввод, кэшированный текстовый ввод, ввод изображений, кэшированный ввод изображений и вывод изображений оплачиваются отдельно. При отправке квота резервируется, а после успеха сумма уточняется по фактическому потреблению токенов с возвратом или доплатой. Формула стоимости в USD:
GIF тарифицируется по выходным токенам всей анимации. Вывод SVG дополнительно создаёт один вызов текстовой модели svg.model поверх токенов изображения. Индивидуальные цены и скидки аккаунта продолжают действовать. Итоговое списание можно проверить в журнале использования; актуальные цены — на странице цен и в настройках аккаунта.

Связанные модели

GPT-Image-2.5 официальный канал, обычная и VIP версии используют собственные полные имена моделей. Для вызова официального канала на этой странице используйте суффикс -official.