Генерация изображений OpenAI
POST /openai/api/v1/images/generations создает изображения с помощью моделей GPT Image и glm-image. Поля описаны в документации OpenAI Create image, модели — в каталоге.
curl https://hub.coreinfra.ai/openai/api/v1/images/generations \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-image-1","prompt":"Белый круг на черном фоне"}'
Фрагмент ответа:
{"data":[{"b64_json":"…"}]}
Отличия от API OpenAI
Поля user и safety_identifier игнорируются. Параметр output_format: "svg" у моделей GPT Image отклоняется со статус-кодом 400.
Вложенные изображения, маска и разметка должны передаваться в кодировке base64 (data:image/...;base64,...) либо загрузками multipart. Непустые file_id и ссылки на внешние ресурсы отклоняются со статус-кодом 400. Действует общий лимит тела.
Для GLM Image
Для glm-image передавайте JSON; ответ возвращается в формате OpenAI Images:
- Генерируется одно изображение. Если
nзадан, он должен быть равен1.stream: true, а также заданныеimages,maskилиmarkupотклоняются со статус-кодом400. - Значения
quality: low,mediumиstandardсоответствуютstandard, аhigh,xhigh,maxиhd—hd. - Игнорируются
size: auto,background,complexity,output_format,frame_count,frame_duration_ms,svg,output_compression,partial_images,moderation,response_format,styleиinput_fidelity. - Сгенерированное изображение возвращается в
data[].b64_json(до 32 МиБ).
Резерв и списание
Для GPT Image резерв учитывает текст, входные изображения и разметку, а также оценку выходных токенов по размеру, количеству изображений и частичным изображениям. Маска не входит в оценку входных токенов. При size: auto или неизвестном размере используется оценка наибольшего изображения модели.
Итоговое списание для GPT Image идет по usage.input_tokens и usage.output_tokens; для GLM Image резервируется и списывается одно изображение. Цены находятся на «Тарифах», правила расчета — на странице «Стоимость генерации изображений».
Ошибки
400— отсутствуетmodel, модель не поддерживает Images, переданы запрещенные вложения илиoutput_format: "svg"у моделей GPT Image, либо нарушены ограниченияglm-image.502— ошибка на стороне провайдера модели при выполнении запроса.
Формат ошибок приведен в разделе OpenAI API; общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике.
