सामग्री पर जाएँ

Ideogram V3 Character

इंटीग्रेट करें

मॉडल id ideogram/character
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/character?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

यह अनुरोध: $0.15 150 API क्रेडिट · ≈ ₽15.82 इसे इस पेज पर चलाएँ

API कुंजी प्राप्त करें
Ideogram इमेज एडिटिंग रेफ़रेंस इनपुट #character-consistency

संदर्भ इमेज का उपयोग करके कैरेक्टर की निरंतरता बनाए रखने वाला Ideogram V3 जनरेशन

Ideogram · इमेज

आपका पहला परिणाम यहाँ आएगा

नीचे एक अनुरोध बनाएँ और उसे अपनी API कुंजी से चलाएँ। आउटपुट हमारे स्टोरेज में कॉपी किए जाते हैं और हमेशा के लिए या 7 दिन तक मुफ़्त में रखे जाते हैं।

अनुरोध बनाएँ

कंट्रोल मॉडल स्कीमा से जनरेट होते हैं। इन्हें बदलने पर कोड और कीमत अपडेट होती है।

•आवश्यक

इमेज के मास्क किए गए क्षेत्र में भरने वाली सामग्री का वर्णन करने वाला प्रॉम्प्ट।

•आवश्यक
फ़ाइल ड्रॉप करें, या

JPEG, PNG या WebP फ़ॉर्मैट में चरित्र संदर्भ इमेज, जिनका सभी चरित्र संदर्भों में संयुक्त आकार 10 MB तक सीमित है। वर्तमान में समर्थन 1 इमेज तक सीमित है; अतिरिक्त इमेज अनदेखी कर दी जाती हैं।

rendering_speed डिफ़ॉल्ट BALANCED

रेंडरिंग के लिए गति सेटिंग।

image_size डिफ़ॉल्ट square_hd

आउटपुट इमेज के लिए उपयोग किया जाने वाला रिज़ॉल्यूशन।

num_images डिफ़ॉल्ट 1

बनाई जाने वाली इमेज की संख्या।

उन्नत negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
डिफ़ॉल्ट

अवांछित इमेज सामग्री निर्दिष्ट करें; मुख्य प्रॉम्प्ट के विवरण इन नेगेटिव-प्रॉम्प्ट विवरणों पर प्राथमिकता रखते हैं।

image_urls
फ़ाइल ड्रॉप करें, या

JPEG, PNG या WebP फ़ॉर्मैट में शैली संदर्भ इमेज। इनका संयुक्त आकार 10 MB से अधिक नहीं होना चाहिए।

फ़ाइल ड्रॉप करें, या

JPEG, PNG या WebP फ़ॉर्मैट में चरित्र-संदर्भ मास्क; सभी चरित्र संदर्भों का कुल आकार 10 MB से अधिक नहीं हो सकता। वर्तमान में केवल 1 मास्क का उपयोग किया जाता है और अतिरिक्त मास्क अनदेखे कर दिए जाते हैं।

style डिफ़ॉल्ट AUTO

निर्माण के लिए उपयोग किया जाने वाला शैली प्रकार; style_codes के साथ परस्पर अनन्य।

रैंडम संख्या निर्माण के लिए seed मान।

इमेज-शैली कोड, जिनमें से प्रत्येक 8 वर्णों की हेक्साडेसिमल स्ट्रिंग के रूप में दिया गया है; इस सूची का उपयोग करते समय style_reference_images और style दोनों छोड़ दें।

निर्माण के दौरान उपयोग किया जाने वाला रंग पैलेट। `name` के माध्यम से कोई प्रीसेट या `members` के माध्यम से स्पष्ट हेक्साडेसिमल रंग निर्दिष्ट करें, और वैकल्पिक रूप से वेट शामिल करें।

POST /run/ideogram/character?wait=20 कोटेशन → $0.15
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/character?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

यह अनुरोध चलाएँ

आपकी key इसी ब्राउज़र में रहती है: इसे केवल Doitong API को भेजा जाता है और केवल तभी (localStorage) में सेव किया जाता है जब आप Remember चुनते हैं। API कुंजी प्राप्त करें

Ideogram V3 Character के बारे में

`prompt` और `reference_image_urls` में दिए गए संदर्भ (केवल 1 इमेज का उपयोग होता है) से कैरेक्टर की इमेज जनरेट करता है। वैकल्पिक स्टाइल संदर्भ `image_urls` में दिए जाते हैं, और अधिक नियंत्रण के लिए `style_codes`, `color_palette` तथा `reference_mask_urls` उपलब्ध हैं। `rendering_speed` TURBO, BALANCED या QUALITY होता है, और `num_images` अधिकतम 8 तक हो सकता है।

पैरामीटर

कैनोनिकल नाम या नेटिव नाम में से कोई एक भेजें, दोनों नहीं। कैनोनिकल नाम

नामप्रकार डिफ़ॉल्टअनुमत विवरण
image_urlsवैकल्पिक images
प्रकारurl[] · image
JPEG, PNG या WebP फ़ॉर्मैट में शैली संदर्भ इमेज। इनका संयुक्त आकार 10 MB से अधिक नहीं होना चाहिए।
rendering_speedवैकल्पिक
प्रकारenum
डिफ़ॉल्टBALANCED
TURBOBALANCEDQUALITY
रेंडरिंग के लिए गति सेटिंग।
color_paletteवैकल्पिक
प्रकारobject
निर्माण के दौरान उपयोग किया जाने वाला रंग पैलेट। `name` के माध्यम से कोई प्रीसेट या `members` के माध्यम से स्पष्ट हेक्साडेसिमल रंग निर्दिष्ट करें, और वैकल्पिक रूप से वेट शामिल करें।
color_palette.membersवैकल्पिक
प्रकारobject[]
पैलेट के रंगों को परिभाषित करने वाली पैलेट सदस्य सूची।
color_palette.members[].rgbआवश्यक
प्रकारobject
RGB के रूप में व्यक्त पैलेट सदस्य का रंग।
color_palette.members[].color_weightवैकल्पिक
प्रकारnumber | null
डिफ़ॉल्ट0.5
0.05 – 1
पैलेट में इस रंग को दिया गया वेट।
color_palette.nameवैकल्पिक
प्रकारenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
रंग पैलेट के लिए प्रीसेट चयन।
style_codesवैकल्पिक
प्रकारstring[]
इमेज-शैली कोड, जिनमें से प्रत्येक 8 वर्णों की हेक्साडेसिमल स्ट्रिंग के रूप में दिया गया है; इस सूची का उपयोग करते समय style_reference_images और style दोनों छोड़ दें।
styleवैकल्पिक
प्रकारenum
डिफ़ॉल्टAUTO
AUTOREALISTICFICTION
निर्माण के लिए उपयोग किया जाने वाला शैली प्रकार; style_codes के साथ परस्पर अनन्य।
expand_promptवैकल्पिक
प्रकारboolean
डिफ़ॉल्टtrue
अनुरोध निर्माण के लिए MagicPrompt उपयोग टॉगल।
num_imagesवैकल्पिक num_outputs
प्रकारinteger
डिफ़ॉल्ट1
1 – 8
बनाई जाने वाली इमेज की संख्या।
seedवैकल्पिक
प्रकारinteger | null
रैंडम संख्या निर्माण के लिए seed मान।
promptआवश्यक
प्रकारstring
इमेज के मास्क किए गए क्षेत्र में भरने वाली सामग्री का वर्णन करने वाला प्रॉम्प्ट।
image_sizeवैकल्पिक
प्रकारobject
डिफ़ॉल्टsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
आउटपुट इमेज के लिए उपयोग किया जाने वाला रिज़ॉल्यूशन।
negative_promptवैकल्पिक
प्रकारstring
डिफ़ॉल्ट
अवांछित इमेज सामग्री निर्दिष्ट करें; मुख्य प्रॉम्प्ट के विवरण इन नेगेटिव-प्रॉम्प्ट विवरणों पर प्राथमिकता रखते हैं।
reference_image_urlsआवश्यक
प्रकारurl[] · image
JPEG, PNG या WebP फ़ॉर्मैट में चरित्र संदर्भ इमेज, जिनका सभी चरित्र संदर्भों में संयुक्त आकार 10 MB तक सीमित है। वर्तमान में समर्थन 1 इमेज तक सीमित है; अतिरिक्त इमेज अनदेखी कर दी जाती हैं।
reference_mask_urlsवैकल्पिक
प्रकारurl[] · image
JPEG, PNG या WebP फ़ॉर्मैट में चरित्र-संदर्भ मास्क; सभी चरित्र संदर्भों का कुल आकार 10 MB से अधिक नहीं हो सकता। वर्तमान में केवल 1 मास्क का उपयोग किया जाता है और अतिरिक्त मास्क अनदेखे कर दिए जाते हैं।
आवश्यक कैनोनिकल नाम, यह भी स्वीकार्य है

फ़ाइल पैरामीटर में सार्वजनिक https:// URL, 10 MB तक का data: URI, या अपलोड का file_url लिया जाता है। फ़ाइलें

आउटपुट

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
आपकी फ़ाइलें, आपकी पसंदहर outputs[].url हमारे स्टोरेज में एक कॉपी है: हमेशा के लिए (प्रति GB-माह भुगतान) या 7 दिन तक मुफ़्त में, आपके अकाउंट की सेटिंग या ?storage= के अनुसार।
हर मॉडल पर एक जैसा आकारइमेज, वीडियो और ऑडियो सभी के लिए type, url, content_type, width, height और duration। output मॉडल का अपना परिणाम ऑब्जेक्ट है।
आउटपुट के फ़ील्ड
images
array of object {url, content_type, file_name, file_size}
seed
integerरैंडम संख्या निर्माण के लिए उपयोग किया जाने वाला seed मान।

और मॉडल: इमेज एडिटिंग

AI एजेंट के लिए: इस पेज का Markdown यहाँ है https://doitong.com/hi/developers/models/ideogram/character.md. सभी मॉडल और गाइड: https://doitong.com/developers/llms.txt