Використовуйте Ideogram Character через Rivya Public API v1 з ID моделі ideogram-character, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.

Доступно через APIГотовністьЗображення

ID моделі API

ideogram-character

Входи

file

Files API

Потрібно для референсних режимів

Базові кредити

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

Можливість

Зображення

Білінг

FIXED

Ліміт промпта

5000 символів

Контракт запиту

Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.

Ключ	Тип	Обов'язково	За замовчуванням	Опис
model	string	Так	ideogram-character	Використовуйте ideogram-character як ID моделі API.
prompt	string	Так	-	Максимум 5000 символів для цієї моделі.
params	object	Ні	-	Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_id	string	Ні	-	Необов'язковий клієнтський ID для трасування запитів у вашій системі.

Параметри моделі

Ключ	Тип	Обов'язково	За замовчуванням	Діапазон	Опції	Опис
rendering_speed	select	Ні	BALANCED	-	TURBO, BALANCED, QUALITY	Баланс між швидкістю, вартістю й деталізацією. Turbo — найшвидший і найдешевший, Quality — найдетальніший і найдорожчий, а Balanced — стандартна середина.
style	select	Ні	AUTO	-	AUTO, REALISTIC, FICTION	Стиль
expand_prompt	select	Ні	true	-	true, false	Перемикач розширення промпту Ideogram. Увімкнення допомагає моделі розгорнути ваш опис; вимкнення краще підходить, коли потрібен щільний контроль промпту.
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Розмір зображення
num_images	select	Ні	1	-	1, 2, 3, 4	Виберіть 1–4 результати. Загальна ціна дорівнює тарифу за зображення, помноженому на вибрану кількість, з округленням вгору до цілих кредитів.
seed	number	Ні	-	-	-	Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.
negative_prompt	text	Ні	-	-	-	Негативний промпт

Політика завантаження

Спочатку завантажте референсні файли, потім розмістіть повернений URL і токен тривалості всередині params.referenceMediaItems.

Правило референсів

Референсне зображення персонажа: Завантажте рівно 1 файл зображення для цього проєкту.

Максимум файлів

Прийняті типи файлів

image

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kind	Максимальний розмір	MIME-типи
image	10 MB	image/jpeg, image/png, image/webp

Мінімальний запит

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Необов'язковий вміст, якого слід уникати"
  }
}

Запит із референсним файлом

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Необов'язковий вміст, якого слід уникати",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Відповідь створення

Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.

{
  "id": "task_ideogram_character_example",
  "status": "queued",
  "model": "ideogram-character",
  "reserved_credits": 18,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Поширені помилки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Деякі режими потребують завантаження референсів через Files API.

API-інтеграція для Ideogram Character