Изображения

Сначала выберите формат модели

У моделей изображений используются два API-сценария. GPT Image и совместимые модели работают через /v1/images/generations и /v1/images/edits. Gemini Image принимает создание и редактирование через /v1/chat/completions. Поддерживаемые маршруты указаны в карточке модели — один и тот же запрос нельзя без изменений отправить модели другого типа.

GPT-совместимая генерация

Передайте текстовое описание в prompt. Поля size, quality, background, output_format и n зависят от выбранной модели; неизвестные или неподдерживаемые значения upstream может отклонить.

1curl https://elysiumai.garden/v1/images/generations   -H "Authorization: Bearer $ELYSIUM_API_KEY"   -H "Content-Type: application/json"   -d '{2    "model": "openai/gpt-image-2",3    "prompt": "Белый мраморный сад у моря, мягкий утренний свет",4    "size": "1024x1024",5    "quality": "high",6    "n": 1,7    "response_format": "b64_json"8  }'

GPT-совместимое редактирование

Для локального файла используйте multipart/form-data. Поле image можно передавать повторно, если модель умеет работать с несколькими референсами. mask необязателен и поддерживается не всеми моделями.

1curl https://elysiumai.garden/v1/images/edits   -H "Authorization: Bearer $ELYSIUM_API_KEY"   -F "model=openai/gpt-image-2"   -F "prompt=Сделай небо закатным, остальные детали сохрани"   -F "image=@source.png"   -F "output_format=png"

Gemini Image через Chat Completions

Для Gemini обязательно запросите изображение в modalities. Параметры изображения передаются в верхнеуровневом image_config, а не внутри messages.

1curl https://elysiumai.garden/v1/chat/completions   -H "Authorization: Bearer $ELYSIUM_API_KEY"   -H "Content-Type: application/json"   -d '{2    "model": "google/gemini-3.1-flash-image-preview",3    "messages": [{4      "role": "user",5      "content": "Нарисуй минималистичный стеклянный павильон в лесу"6    }],7    "modalities": ["image", "text"],8    "image_config": {9      "aspect_ratio": "16:9",10      "image_size": "2K"11    }12  }'

Как прочитать результат

GPT-совместимый ответ содержит массив data. Gemini-совместимый ответ содержит массив images внутри сообщения ассистента. В обоих форматах изображение может прийти временной URL-ссылкой или base64/data URL — приложение должно обрабатывать оба варианта.

1{2  "created": 1780000000,3  "data": [{"b64_json": "iVBORw0KGgoAAA..."}]4}

Параметры изображений

Как считается стоимость

В каталоге рядом с моделью указан принцип расчёта. Для режима «за изображение» стоимость равна количеству реально созданных изображений, умноженному на цену одного выхода. Для режима «по токенам» отдельно считаются входные, выходные и cache-токены по ценам за 1M. GPT Image 1.5 и GPT Image 2 используют токенный режим; Gemini 3 Pro Image и Seedream 5.0 Pro — цену за выходное изображение.

1cost = output_image_count × output_image_price2 3Пример: 3 изображения × $0.0217728 = $0.0653184

Частые ошибки

Термины на этой странице

Короткая расшифровка обозначений, которые встречаются в этом разделе.