İçeriğe geç

Ideogram V3 Character

Entegre et

Model kimliği 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"

Bu istek: $0,15 150 API kredisi · ≈ ₽15,70 Bu sayfada çalıştır

API anahtarı al
Ideogram Görsel Düzenleme Referans girdileri #character-consistency

Referans görüntü kullanarak karakter tutarlılığını koruyan Ideogram V3 üretimi

Ideogram · Görsel

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli

Görselin maskeli bölgesindeki doldurmayı açıklayan istem.

•gerekli
Dosyayı bırakın veya

JPEG, PNG veya WebP biçimindeki karakter referansı görselleri; tüm karakter referansları için birleşik sınır 10 MB'dır. Şu anda destek 1 görselle sınırlıdır; ek görseller yok sayılır.

rendering_speed varsayılan BALANCED

İşleme hızı ayarı.

image_size varsayılan square_hd

Çıktı görseli için kullanılacak çözünürlük.

num_images varsayılan 1

Üretilecek görsel sayısı.

Gelişmiş negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
varsayılan

İstenmeyen görsel içeriğini belirtir; ana istemin açıklamaları bu negatif istem açıklamalarına göre önceliklidir.

image_urls
Dosyayı bırakın veya

JPEG, PNG veya WebP biçimindeki stil referansı görselleri. Birleşik boyutları 10 MB'ı aşmamalıdır.

Dosyayı bırakın veya

JPEG, PNG veya WebP biçimindeki karakter referansı maskeleri; tüm karakter referanslarının toplam boyutu 10 MB'ı aşamaz. Şu anda yalnızca 1 maske kullanılır; ek maskeler yok sayılır.

style varsayılan AUTO

Üretimde kullanılan stil türü; style_codes ile birlikte kullanılamaz.

Rastgele sayı üretimi için tohum değeri.

Her biri 8 karakterlik onaltılık dizeler olarak sağlanan görsel stil kodları; bu listeyi kullanırken style_reference_images ve style değerlerinin ikisini de belirtmeyin.

Üretim sırasında kullanılan renk paleti. name aracılığıyla bir hazır ayar veya members aracılığıyla açık onaltılık renkler belirtin; isteğe bağlı olarak ağırlıklar eklenebilir.

POST /run/ideogram/character?wait=20 fiyat → $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"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Ideogram V3 Character hakkında

`prompt` ve `reference_image_urls` içindeki bir referansı (yalnızca 1 görüntü kullanılır) temel alarak karakter görüntüleri üretir. İsteğe bağlı stil referansları `image_urls` içine eklenir; daha fazla kontrol için `style_codes`, `color_palette` ve `reference_mask_urls` kullanılabilir. `rendering_speed` TURBO, BALANCED veya QUALITY olabilir ve `num_images` en fazla 8'dir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlsisteğe bağlı images
Türurl[] · image
JPEG, PNG veya WebP biçimindeki stil referansı görselleri. Birleşik boyutları 10 MB'ı aşmamalıdır.
rendering_speedisteğe bağlı
Türenum
VarsayılanBALANCED
TURBOBALANCEDQUALITY
İşleme hızı ayarı.
color_paletteisteğe bağlı
Türobject
Üretim sırasında kullanılan renk paleti. name aracılığıyla bir hazır ayar veya members aracılığıyla açık onaltılık renkler belirtin; isteğe bağlı olarak ağırlıklar eklenebilir.
color_palette.membersisteğe bağlı
Türobject[]
Paletin renklerini tanımlayan palet üyesi listesi.
color_palette.members[].rgbgerekli
Türobject
Palet üyesinin RGB olarak ifade edilen rengi.
color_palette.members[].color_weightisteğe bağlı
Türnumber | null
Varsayılan0.5
0,05 – 1
Palet içinde bu renge atanan ağırlık.
color_palette.nameisteğe bağlı
Türenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Renk paleti için hazır ayar seçimi.
style_codesisteğe bağlı
Türstring[]
Her biri 8 karakterlik onaltılık dizeler olarak sağlanan görsel stil kodları; bu listeyi kullanırken style_reference_images ve style değerlerinin ikisini de belirtmeyin.
styleisteğe bağlı
Türenum
VarsayılanAUTO
AUTOREALISTICFICTION
Üretimde kullanılan stil türü; style_codes ile birlikte kullanılamaz.
expand_promptisteğe bağlı
Türboolean
Varsayılantrue
İstek üretimi için MagicPrompt kullanım anahtarı.
num_imagesisteğe bağlı num_outputs
Türinteger
Varsayılan1
1 – 8
Üretilecek görsel sayısı.
seedisteğe bağlı
Türinteger | null
Rastgele sayı üretimi için tohum değeri.
promptgerekli
Türstring
Görselin maskeli bölgesindeki doldurmayı açıklayan istem.
image_sizeisteğe bağlı
Türobject
Varsayılansquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Çıktı görseli için kullanılacak çözünürlük.
negative_promptisteğe bağlı
Türstring
Varsayılan
İstenmeyen görsel içeriğini belirtir; ana istemin açıklamaları bu negatif istem açıklamalarına göre önceliklidir.
reference_image_urlsgerekli
Türurl[] · image
JPEG, PNG veya WebP biçimindeki karakter referansı görselleri; tüm karakter referansları için birleşik sınır 10 MB'dır. Şu anda destek 1 görselle sınırlıdır; ek görseller yok sayılır.
reference_mask_urlsisteğe bağlı
Türurl[] · image
JPEG, PNG veya WebP biçimindeki karakter referansı maskeleri; tüm karakter referanslarının toplam boyutu 10 MB'ı aşamaz. Şu anda yalnızca 1 maske kullanılır; ek maskeler yok sayılır.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
images
array of object {url, content_type, file_name, file_size}
seed
integerRastgele sayı üretimi için kullanılan tohum değeri.

Daha fazla model: Görsel Düzenleme

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/ideogram/character.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt