Параметр
promptобяз.Тип
текст
Значения
текстовое описание
По умолчанию
обязательный
Цена
—
PlusVibeAPIТема
Изображения
Ideogram v3 API в России — как подключить и оплатить рублями
Ideogram v3 — лидер по рендеру текста на изображениях. Режимы: генерация, редактирование, ремикс и кадрирование, три скорости рендера.
Цена под задачу
Соберите подходящий результат
ideogram-v3:pixelНа вход: Текст, ИзображениеДля некоторых режимов нужно приложить: исходное изображение, seed for reproducibility, negative prompt (what to exclude)
Что такое Ideogram v3
Ideogram v3 — лидер по рендеру текста на изображениях. Режимы: генерация, редактирование, ремикс и кадрирование, три скорости рендера.
Кратко о контракте
- Вход
- text, image
- Выход
- image
- Режим
- асинхронный (job + polling)
- Опрос статуса
- каждые 3 с · до 90 с
Рабочие показатели (7d)
По реальному трафику PlusVibe · малая выборка.
- Доступность
- —
- Средняя задержка
- —
- TTFT
- —
- Запросов
- 3
Сильные стороны
- Лучший в классе рендер текста
- Четыре режима работы
- Скорости Turbo/Default/Quality
- Хорошая композиция
Где применяют
- Постеры и баннеры с текстом
- Логотипы и обложки
- Соцсети и инфографика
- Меню и прайс-листы
API контракт
Генерация идёт асинхронно: создайте задачу, затем опрашивайте её статус до завершения.
- Создать задачу
- POST /api/media/generate
- Проверить статус
- GET /api/media/jobs/{jobId}
- Вход
- text, image
- Выход
- image
- Опрос
- каждые 3 с · до 90 с
- Аутентификация
- Authorization: Bearer sk-pv-…
Пример запроса
Передайте ключ в Bearer-заголовке. API вернёт jobId для опроса статуса.
curl -sS https://plusvibeapi.ru/api/media/generate \
-H "Authorization: Bearer $PLUSVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"ideogram-v3:pixel","prompt":"a beautiful landscape","opts":{"mode":"text-to-image","aspect_ratio":"1:1","rendering_speed":"DEFAULT","style":"AUTO","expand_prompt":false,"num_images":"1"}}'JavaScript
const response = await fetch('https://plusvibeapi.ru/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PLUSVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "ideogram-v3:pixel",
"prompt": "a beautiful landscape",
"opts": {
"mode": "text-to-image",
"aspect_ratio": "1:1",
"rendering_speed": "DEFAULT",
"style": "AUTO",
"expand_prompt": false,
"num_images": "1"
}
}),
});
if (!response.ok) throw new Error(`PlusVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);Параметры API запроса
Параметры для запросов к Ideogram v3 через API PlusVibe.
Параметр
image_urlТип
URL
Значения
публичный URL изображения
По умолчанию
—
Цена
—
Параметр
aspect_ratioТип
выбор варианта
Значения
1:1 (по умолчанию) · 16:9 · 9:16 · 4:3 · 3:4
По умолчанию
1:1
Цена
включено в базовую цену
Параметр
modeТип
выбор варианта
Значения
Генерация (текст → изображение) (по умолчанию) · Редактирование (только Canvas) · Ремикс · Кадрирование
По умолчанию
Генерация (текст → изображение)
Цена
включено в базовую цену
Параметр
rendering_speedТип
выбор варианта
Значения
Turbo · Default (по умолчанию) · Quality
По умолчанию
Default
Цена
Turbo: 2,20 ₽, Default: 4,40 ₽, Quality: 6,29 ₽
Параметр
styleТип
выбор варианта
Значения
Авто (по умолчанию) · General · Realistic · Design
По умолчанию
Авто
Цена
включено в базовую цену
Параметр
expand_promptТип
да/нет
Значения
Да · Нет (по умолчанию)
По умолчанию
Нет
Цена
включено в базовую цену
Параметр
seedТип
текст / число
Значения
любое значение
По умолчанию
—
Цена
включено в базовую цену
Параметр
negative_promptТип
текст / число
Значения
любое значение
По умолчанию
—
Цена
включено в базовую цену
Параметр
strengthТип
выбор варианта
Значения
0.8 (по умолчанию) (по умолчанию) · 0.2 · 0.4 · 0.6 · 1.0
По умолчанию
0.8 (по умолчанию)
Цена
включено в базовую цену
Параметр
num_imagesТип
выбор варианта
Значения
1 (по умолчанию) · 2 · 3 · 4
По умолчанию
1
Цена
включено в базовую цену
Параметр
image_file_idТип
текст
Значения
Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…)
По умолчанию
—
Цена
включено в базовую цену
Параметр
image_base64Тип
текст
Значения
Alternative to image_url: the file inline, as base64 or a data: URI
По умолчанию
—
Цена
включено в базовую цену
| Параметр | Тип | Значения | По умолчанию | Цена |
|---|---|---|---|---|
promptобяз. | текст | текстовое описание | обязательный | — |
image_url | URL | публичный URL изображения | — | — |
aspect_ratio | выбор варианта | 1:1 (по умолчанию) · 16:9 · 9:16 · 4:3 · 3:4 | 1:1 | включено в базовую цену |
mode | выбор варианта | Генерация (текст → изображение) (по умолчанию) · Редактирование (только Canvas) · Ремикс · Кадрирование | Генерация (текст → изображение) | включено в базовую цену |
rendering_speed | выбор варианта | Turbo · Default (по умолчанию) · Quality | Default | Turbo: 2,20 ₽, Default: 4,40 ₽, Quality: 6,29 ₽ |
style | выбор варианта | Авто (по умолчанию) · General · Realistic · Design | Авто | включено в базовую цену |
expand_prompt | да/нет | Да · Нет (по умолчанию) | Нет | включено в базовую цену |
seed | текст / число | любое значение | — | включено в базовую цену |
negative_prompt | текст / число | любое значение | — | включено в базовую цену |
strength | выбор варианта | 0.8 (по умолчанию) (по умолчанию) · 0.2 · 0.4 · 0.6 · 1.0 | 0.8 (по умолчанию) | включено в базовую цену |
num_images | выбор варианта | 1 (по умолчанию) · 2 · 3 · 4 | 1 | включено в базовую цену |
image_file_id | текст | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | включено в базовую цену |
image_base64 | текст | Alternative to image_url: the file inline, as base64 or a data: URI | — | включено в базовую цену |
Запрос: POST https://plusvibeapi.ru/api/media/generate. Цены в рублях по текущему курсу ЦБ РФ.
Цена Ideogram v3 в рублях
Стоимость Ideogram v3: от 2,37 ₽ за изображение. Цена рассчитывается динамически по курсу ЦБ РФ, итоговое списание видно в ответе API (priceRub). Оплата в рублях, без подписок.
Что спишется за запрос по умолчанию
Если не передать параметры, запрос уйдёт с этими значениями: Скорость генерации — Default, Сценарий — Генерация (текст → изображение), Формат кадра — 1:1, Стиль — Авто. Такой запрос стоит 4,40 ₽.
«от 2,37 ₽» — это самый дешёвый набор параметров, а не цена запроса по умолчанию.
Провайдер
Цена, поддержка параметров и метрики реального трафика по каждому публичному провайдеру.
Провайдер
Pixelпо умолчанию
ideogram-v3:pixelСтатус
не проверено
Цена
2,37 ₽
Параметры
общий контракт
Доступность
—
TTFT
—
Скорость
—
Кеш-хит
—
Caching
нет
Провайдер
Canvas
ideogram-v3:repСтатус
не проверено
Цена
7,54 ₽
Параметры
общий контракт
Доступность
—
TTFT
—
Скорость
—
Кеш-хит
—
Caching
нет
| Провайдер | Статус | Цена | Параметры | Доступность | TTFT | Скорость | Кеш-хит | Caching |
|---|---|---|---|---|---|---|---|---|
Pixelпо умолчанию ideogram-v3:pixel | не проверено | 2,37 ₽ | общий контракт | — | — | — | — | нет |
Canvas ideogram-v3:rep | не проверено | 7,54 ₽ | общий контракт | — | — | — | — | нет |
Метрики за 7d по реальному трафику · малая выборка. Пустые ячейки = метрика не измеряется или нет наблюдений.
Каналы и цены по всем сочетаниям параметров
Для каждого канала — цена каждого сочетания параметров. Это ровно та сумма, которая списывается за успешную генерацию, и та же, что в машиночитаемой таблице по ссылке.
Pixelideogram-v3:pixelдоступенесть ориентировочные ячейки (≈)
| Скорость | Turbo | Default | Quality |
|---|---|---|---|
| Pixel | ≈ 2,37 ₽ | ≈ 4,74 ₽ | ≈ 6,77 ₽ |
≈ Списывается по кредитам, которые поставщик насчитал за эту задачу: не больше этой цены, иногда меньше.
Все сочетания в JSON: /api/media/price-table?model=ideogram-v3%3Apixel
Canvasideogram-v3:repдоступенот 3,77 ₽точные цены
| Скорость | Turbo | Default | Quality |
|---|---|---|---|
| Canvas | 3,77 ₽ | 7,54 ₽ | 11,31 ₽ |
Все сочетания в JSON: /api/media/price-table?model=ideogram-v3%3Arep
README
Машиночитаемый контракт Ideogram v3 содержит схему запроса, операции, лимиты, поллинг и примеры ответа.
# Ideogram v3
Публичная модель: ideogram-v3:pixel
Создать задачу: POST /api/media/generate
Проверить статус: GET /api/media/jobs/{jobId}
## Входные параметры
- `prompt` (текст): текстовое описание; по умолчанию: обязательный
- `image_url` (URL): публичный URL изображения; по умолчанию: —
- `aspect_ratio` (выбор варианта): 1:1 (по умолчанию) · 16:9 · 9:16 · 4:3 · 3:4; по умолчанию: 1:1
- `mode` (выбор варианта): Генерация (текст → изображение) (по умолчанию) · Редактирование (только Canvas) · Ремикс · Кадрирование; по умолчанию: Генерация (текст → изображение)
- `rendering_speed` (выбор варианта): Turbo · Default (по умолчанию) · Quality; по умолчанию: Default
- `style` (выбор варианта): Авто (по умолчанию) · General · Realistic · Design; по умолчанию: Авто
- `expand_prompt` (да/нет): Да · Нет (по умолчанию); по умолчанию: Нет
- `seed` (текст / число): любое значение; по умолчанию: —
- `negative_prompt` (текст / число): любое значение; по умолчанию: —
- `strength` (выбор варианта): 0.8 (по умолчанию) (по умолчанию) · 0.2 · 0.4 · 0.6 · 1.0; по умолчанию: 0.8 (по умолчанию)
- `num_images` (выбор варианта): 1 (по умолчанию) · 2 · 3 · 4; по умолчанию: 1
- `image_file_id` (текст): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); по умолчанию: —
- `image_base64` (текст): Alternative to image_url: the file inline, as base64 or a data: URI; по умолчанию: —
## Публичные варианты
- `ideogram-v3:pixel`: Pixel
- `ideogram-v3:rep`: CanvasОплата рублями и для бизнеса
- Оплата в рублях
- Картой РФ или по счёту (безнал) для юрлиц и ИП. Без зарубежных карт и VPN.
- Закрывающие документы
- Договор и акты для юрлиц и ИП. ЭДО с любым оператором (Диадок, СБИС и др.).
- Единый ₽-биллинг
- Один баланс на все модели — текст, изображения и видео. Оплата за использование.
- Данные в РФ + 152-ФЗ
- Эндпоинт plusvibeapi.ru, авто-маскинг ПДн включён по умолчанию для всех ключей.
Подключаете Ideogram v3 для компании? Страница для бизнеса — оплата по счёту, договор, закрывающие документы и ЭДО.
Частые вопросы про Ideogram v3 API
Как подключить Ideogram v3 по API из России?
Зарегистрируйтесь в PlusVibe, пополните баланс в рублях и получите ключ. Укажите базовый адрес https://plusvibeapi.ru/v1, ваш ключ и model="ideogram-v3" — работает с любым OpenAI-совместимым SDK. VPN и зарубежные карты не нужны.
Сколько стоит Ideogram v3 в рублях?
Цена Ideogram v3: от 2,37 ₽ за изображение. Цена рассчитывается динамически по курсу ЦБ РФ.
Нужен ли VPN или иностранная карта?
Нет. Запросы идут на российский эндпоинт plusvibeapi.ru, оплата — картой РФ или по счёту в рублях. VPN и зарубежные счета не требуются.
Можно ли оплатить по счёту и получить закрывающие документы?
Да. Для юрлиц и ИП доступна оплата по счёту (безнал), договор и закрывающие документы (акты). ЭДО с любым оператором (Диадок, СБИС и др.).
Совместимо ли это с OpenAI SDK?
Да, API полностью OpenAI-совместимый. Достаточно поменять base_url на https://plusvibeapi.ru/v1 и указать ваш ключ — остальной код не меняется.
Как защитить персональные данные при работе с Ideogram v3?
Авто-маскинг ПДн включён для всех ключей по умолчанию и не отключается — это обязательная защита по 152-ФЗ. Сервис перехватывает запрос на российском сервере, заменяет email, телефон, ФИО, ИНН, СНИЛС и адреса на анонимные метки, отправляет обезличенный текст модели, а затем восстанавливает данные в ответе. Карта меток хранится только в RAM одного запроса — не логируется и не покидает РФ.
Подключите Ideogram v3 прямо сейчас
Регистрация за минуту, оплата в рублях, готовый код выше. VPN не нужен.
Получить API-ключ