Ideogram Character

IdeogramИзображения

Ideogram Character: один портрет на входе — тот же персонаж в новых сценах, позах и стилях.

Наша цена
$0.13
за изображение
Официальная
$0.15
15% к официальной

Первый запрос

from openai import OpenAI

client = OpenAI(
    base_url="https://api.altrouter.ai/v1",
    api_key="ar-...",
)

img = client.images.generate(
    model="ideogram-character",
    prompt="a red fox in the snow",
)
print(img.data[0].url)

Интерфейс OpenAI-совместимый: в готовом коде меняются только base_url, ключ и идентификатор модели — остальное трогать не нужно.

Ideogram Character и соседи по цене

Ideogram Character и ближайшие по цене модели: цены и параметры из каталога AltRouter AI
МодельЦенаЕдиницаСкидка
Midjourney V8Midjourney$0.074изображениеОткрыть
FLUX.1 Kontext MaxBlack Forest$0.082изображениеОткрыть
FLUX.2 FlexBlack Forest$0.089изображениеОткрыть
Nano Banana ProGoogle$0.12изображение−10%Открыть
Ideogram Characterэта модельIdeogram$0.13изображение−15%

Цены и параметры — из того же каталога, что и прайс выше; это не бенчмарк, а сопоставимые условия оплаты.

Лимиты

Цена фиксированная — $0.13 за изображение, независимо от длины промпта. Допустимые значения image_size: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.

Подписки нет: деньги списываются за каждый успешный запрос по цене выше, а неудавшийся не оплачивается. Это уже цена со скидкой 15% от официальной цены вендора — официальная показана рядом зачёркнутой, чтобы её можно было сверить. Отдельного аккаунта у Ideogram для этого не нужно, и VPN тоже: запрос уходит на api.altrouter.ai, а до вендора ходим мы.

Ограничение частоты общее для всех моделей и считается на ключ: 600 запросов в минуту по умолчанию, при превышении — 429 с заголовком retry-after: 60. Для отдельного ключа лимит и потолок трат за день, неделю, месяц или всё время настраиваются в кабинете.

Полные лимиты и кредиты

Когда выбирать Ideogram Character, а когда соседнюю

Дешевле рядом — Nano Banana Pro: $0.12 за изображение против $0.13 у Ideogram Character. На одном и том же объёме счёт выходит в 1,1 раза меньше. Это разумный выбор там, где задача типовая и её много: разметка, классификация, короткие ответы по шаблону — то есть там, где качество упирается не в модель, а в промпт.

Проверять догадки здесь дешевле, чем рассуждать: сравнение выше — это цены и параметры, а не бенчмарк, и оно не скажет, какая модель лучше именно на вашем промпте. Переключение стоит одной строки — меняется идентификатор модели в запросе, base_url и ключ остаются те же, — так что прогнать обе на своих данных занимает минуты.

API

OpenAI-совместимый эндпоинт генерации изображений. Результат рехостится на наш CDN и возвращается ссылкой.

POST/v1/images/generations
Параметры тела
modelstringrequired"ideogram-character"
Идентификатор модели.
promptstringrequired
Текстовое описание изображения.
imagestringURL или base64
Референсные изображения для редактирования.
image_sizeenumsquare_hd · square · portrait_4_3 · portrait_16_9 · landscape_4_3 · landscape_16_9default square_hd
Пресет размера/ориентации изображения.
styleenumAUTO · REALISTIC · FICTIONdefault AUTO
expand_promptbooleandefault true
negative_promptstring
Что исключить из изображения.
seednumber0–2147483647
Seed для воспроизводимости.
Ответ
createdinteger
Unix-время создания (сек).
dataarray
Изображения. Каждое: url (ссылка на наш CDN), b64_json, revised_prompt.
Пример
cURLPythonJavaScriptJSON
curl https://api.altrouter.ai/v1/images/generations \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-character",
  "prompt": "a red fox in the snow",
  "image_size": "square_hd",
  "style": "AUTO"
}'
Ошибки
400Некорректный запрос.
401Нет или неверный API-ключ.
402Недостаточно кредитов или исчерпан потолок трат ключа.
404Модель не найдена.
429Превышен лимит запросов.

Частые вопросы

Сколько стоит Ideogram Character через API?
$0.13 за изображение. Это на 15% ниже официальной цены вендора — $0.15. Счёт ведётся в рублях, баланс пополняется картой РФ, через СБП или криптой — зарубежная карта не нужна.
Работает ли Ideogram Character из России?
Да, и без VPN. Запрос уходит на api.altrouter.ai, а до Ideogram ходим мы, а не вы. Отдельный аккаунт у вендора при этом не нужен.
Как подключить Ideogram Character?
Через тот же ключ и тот же адрес https://api.altrouter.ai/v1, что и текстовые модели. Модель указывается идентификатором ideogram-character.
Справочник API
Можно ли попробовать Ideogram Character бесплатно?
Отдельного бесплатного тарифа нет. За подтверждённый Telegram на баланс начисляется $1 — один раз на человека, этого хватает, чтобы прогнать модель на своей задаче до того, как платить.

Ещё от Ideogram