உள்ளடக்கத்திற்குச் செல்க

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

இந்தக் கோரிக்கை: $0.15 150 API கிரெடிட்கள் இந்தப் பக்கத்தில் இயக்குங்கள்

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

இந்தக் கோரிக்கையை இயக்கு

உங்கள் key இந்த உலாவியில் மட்டுமே இருக்கும்: அது Doitong API-க்கு மட்டும் அனுப்பப்படும்; Remember-ஐத் தேர்ந்தெடுத்தால் மட்டுமே (localStorage)-ல் சேமிக்கப்படும். 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
உங்கள் கோப்புகள், உங்கள் தேர்வுஒவ்வொரு outputs[].url-ம் எங்கள் சேமிப்பகத்தில் உள்ள ஒரு நகல்: நிரந்தரமாக (GB-மாதத்திற்கு கட்டணம்) அல்லது உங்கள் கணக்கு அமைப்பு அல்லது ?storage= மூலம் இலவசமாக 7 நாட்கள் வைக்கப்படும்.
ஒவ்வொரு மாடலிலும் ஒரே வடிவம்படங்கள், வீடியோ மற்றும் ஆடியோ ஆகிய அனைத்திற்குமான 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/ta/developers/models/ideogram/character.md. அனைத்து மாடல்களும் வழிகாட்டிகளும்: https://doitong.com/developers/llms.txt