Ideogram Character modelini Rivya Public API v1 üzerinden model id ideogram-character, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirHazırlıkGörsel

API model kimliği

ideogram-character

Girişler

file

Files API

Referans modları için gerekli

Temel krediler

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

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

5000 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	ideogram-character	ideogram-character API model kimliği değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 5000 karakter.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
rendering_speed	select	Hayır	BALANCED	-	TURBO, BALANCED, QUALITY	Hız, maliyet ve ayrıntı dengesini kurar. Turbo en hızlı ve en ucuz seçenektir, Quality en ayrıntılı ve en pahalı seçenektir, Balanced ise varsayılan orta noktadır.
style	select	Hayır	AUTO	-	AUTO, REALISTIC, FICTION	Stil
expand_prompt	select	Hayır	true	-	true, false	Ideogram'ın istem genişletme anahtarıdır. Açmak, modelin açıklamanızı detaylandırmasına yardımcı olur; kapatmak ise sıkı istem kontrolü istediğinizde daha uygundur.
image_size	select	Hayır	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Görsel boyutu
num_images	select	Hayır	1	-	1, 2, 3, 4	1–4 çıktı seçin. Toplam, görsel başı ücretin seçilen sayıyla çarpılıp tam krediye yukarı yuvarlanmasıdır.
seed	number	Hayır	-	-	-	Her seferinde yeni bir rastgele sonuç için boş bırakın. Aynı tam sayıyı yeniden kullanmak, önceki bir sonucu yeniden üretmeyi veya ince ayar yapmayı kolaylaştırır. Yalnızca istem ve diğer temel ayarlar da benzer kaldığında sonuca daha yakın durur; bire bir eşleşme garanti değildir.
negative_prompt	text	Hayır	-	-	-	Negatif istem

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Karakter referans görseli: Bu proje için tam olarak 1 görsel dosyası yükleyin.

Maks. dosya

Kabul edilen dosya türleri

image

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	10 MB	image/jpeg, image/png, image/webp

Minimal istek

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Kaçınılacak isteğe bağlı içerik"
  }
}

Referans dosyalı istek

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Kaçınılacak isteğe bağlı içerik",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

{
  "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
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Ideogram Character API Entegrasyonu