Rivya Public API v1 के जरिए मॉडल ID ideogram-character, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Ideogram Character का उपयोग करें।

API से उपलब्धउपलब्धता स्थितिइमेज

API मॉडल ID

ideogram-character

इनपुट

file

Files API

संदर्भ मोड के लिए जरूरी

बेस क्रेडिट

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

क्षमता

इमेज

बिलिंग

FIXED

प्रॉम्प्ट सीमा

5000 अक्षर

रिक्वेस्ट संरचना

मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल `params` में रखें।

कुंजी	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	ideogram-character	ideogram-character API मॉडल ID का उपयोग करें।
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 और `durationToken` को `params.referenceMediaItems` में रखें।

संदर्भ नियम

चरित्र संदर्भ इमेज: इस प्रोजेक्ट के लिए ठीक 1 इमेज फाइल अपलोड करें।

अधिकतम फाइलें

स्वीकार्य फाइल प्रकार

image

`durationToken`

अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला `durationToken` होना चाहिए।

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 संदर्भ अपलोड जरूरी हैं।

Ideogram Character API इंटीग्रेशन