Генерация изображений · ideogram

Ideogram 4.5

ideogram-4-5

Ideogram 4.5 — генерация изображений от ideogram, доступная через единый Ranvik API. Поддерживаемые возможности: image_to_image, text_to_image.

от 1.06 ₽ / шт

Карточка модели

Технические характеристики

МодальностьГенерация изображений

Провайдерideogram

СтатусАктивна

ID для запросовideogram-4-5

Возможности

Редактирование изображений
Изображение по тексту

Цены

Единица	Цена
за изображение · very_low	1.06 ₽
за изображение · low	3.99 ₽
за изображение · medium	7.98 ₽
за изображение · high	26.6 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр	Тип	Диапазон / values	Default	Описание
`positivePrompt`required	string	min: 1 · max: 10000	—	Описание изображения или требуемого изменения. примеры значений Примеры Красный куб на белом фоне
`width`	integer	—	—	Парный к height. Для текста только combos; для референсов минимум 256, площадь до 4.19 MP, пропорции 1:6–6:1. Несовместим с маской.
`height`	integer	—	—	Парный к width, те же ограничения. Несовместим с маской.
`seed`	integer	min: 0 · max: 2147483647	—	Сид для воспроизводимости. примеры значений Примеры 0
`inputs.referenceImages`	array of strings	min: 1 · max: 5	—	Первый референс — исходник, остальные направляют редактирование; с маской максимум 4. Изображения до 25 MB, пропорции 1:6–6:1. примеры значений Примеры [ "https://example.com/source.png" ]
`inputs.maskImage`	string	—	—	Маска размера исходника: белое меняется, черное сохраняется. Требует исходник; несовместима с width/height.
`settings.quality`	enum	very_low, low, medium, high	high	Качество. very_low только с исходником/референсом.
`settings.copyrightDetection`	boolean	—	—	Проверка авторских прав после генерации.
`settings.magicPrompt`	enum	auto, on, off	—	Расширение промпта; только текстовый режим, несовместимо с referenceImages.
`outputType`	enum	URL, base64Data, dataURI	URL	Формат доставки результата.
`outputFormat`	enum	JPG, PNG, WEBP	JPG	Формат файла.
`outputQuality`	integer	min: 20 · max: 99	95	Качество сжатия.
`numberResults`	integer	min: 1 · max: 20	1	Количество результатов; цена умножается на количество.
`safety.checkContent`	boolean	—	—	Проверка безопасности контента.
`uploadEndpoint`	string	—	—	URL загрузки результата через PUT. примеры значений Примеры https://storage.example.com/result
`advancedFeatures.watermark.text`	string	min: 2 · max: 32	—	Текст водяного знака; несовместим с image.
`advancedFeatures.watermark.image`	string	—	—	Изображение водяного знака; несовместимо с text.
`advancedFeatures.watermark.displayPosition`	enum	top-left, top-center, top-right, center-left, center-center, center-right, bottom-left, bottom-center, bottom-right, tiled	—	Позиция водяного знака.
`advancedFeatures.watermark.opacity`	number	min: 0.1 · max: 1	—	Прозрачность.
`advancedFeatures.watermark.fontColor`	string	—	—	Цвет текста в HEX.
`advancedFeatures.watermark.bgColor`	string	—	—	Цвет фона в HEX.

Поддерживаемые размеры

Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.

2048x2048

2048×2048

1440x2880

1440×2880

2880x1440

2880×1440

1664x2496

1664×2496

2496x1664

2496×1664

1792x2240

1792×2240

2240x1792

2240×1792

1440x2560

1440×2560

2560x1440

2560×1440

1600x2560

1600×2560

2560x1600

2560×1600

1728x2304

1728×2304

2304x1728

2304×1728

1296x3168

1296×3168

3168x1296

3168×1296

1152x2944

1152×2944

2944x1152

2944×1152

1248x3328

1248×3328

3328x1248

3328×1248

1280x3072

1280×3072

3072x1280

3072×1280

1024x3072

1024×3072

3072x1024

3072×1024

1024x1024

1024×1024

896x1120

896×1120

1120x896

1120×896

864x1152

864×1152

1152x864

1152×864

832x1248

832×1248

1248x832

1248×832

800x1280

800×1280

1280x800

1280×800

720x1280

720×1280

1280x720

1280×720

720x1440

720×1440

1440x720

1440×720

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

from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.images.generate(
    model= "ideogram-4-5",
    positivePrompt= "Пример промпта",
    width= 1,
    height= 1,
    seed= 1073741824,
    outputType= "URL",
    outputFormat= "JPG",
    outputQuality= 95,
    numberResults= 1,
    uploadEndpoint= "value",
    inputs= {
        "referenceImages": [],
        "maskImage": "Пример промпта"
    },
    settings= {
        "quality": "high",
        "copyrightDetection": False,
        "magicPrompt": "auto"
    },
    safety= {
        "checkContent": False
    },
    advancedFeatures= {
        "watermark": {
            "text": "Пример промпта",
            "image": "https://example.com/input.png",
            "displayPosition": "top-left",
            "opacity": 0.55,
            "fontColor": "value",
            "bgColor": "value"
        }
    },
)
print(resp)

Замените rk_live_... на ваш ключ из кабинета.