İçeriğe geç

Ideogram V3 Edit

Entegre et

Model kimliği ideogram/v3/edit
# 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/v3/edit?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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,06 60 API kredisi · ≈ ₽6,33 Bu sayfada çalıştır

API anahtarı al
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 image_url
Dosyayı bırakın veya

Maske ile karşılık gelen boyutlarda hem genişlik hem yüksekliğin tam olarak eşleşmesi gereken, görsel URL'si olarak sağlanan üretim kaynağı.

•gerekli mask_url
Dosyayı bırakın veya

Girdi görselinin karşılık gelen boyutlarıyla hem genişlik hem yüksekliğin tam olarak eşleşmesi gereken URL yoluyla sağlanan iç boyama maskesi.

rendering_speed varsayılan BALANCED

İşleme hızı ayarı.

num_images varsayılan 1

Üretilecek görsel sayısı.

Gelişmiş images · style_preset · seed · expand_prompt · style_codes · color_palette
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.

Seçimi görsel üretimini yönlendiren stil ön ayarı.

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/v3/edit?wait=20 fiyat → $0,06
# 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/v3/edit?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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 Edit hakkında

Bir görüntünün maskelenmiş alanını `prompt` doğrultusunda doldurur. Görüntü (`image_url`) ve maske (`mask_url`) aynı boyutlarda olmalıdır. Stil; referans görüntüler, `style_codes`, `color_palette` veya `style_preset` ile yönlendirilebilir. Oluşturma hızı TURBO, BALANCED veya QUALITY'dir ve 1-8 görüntü döndürülebilir.

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.
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.
style_presetisteğe bağlı
Türenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 tane dahaCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
Seçimi görsel üretimini yönlendiren stil ön ayarı.
promptgerekli
Türstring
Görselin maskeli bölgesindeki doldurmayı açıklayan istem.
image_urlgerekli image
Türurl · image
Maske ile karşılık gelen boyutlarda hem genişlik hem yüksekliğin tam olarak eşleşmesi gereken, görsel URL'si olarak sağlanan üretim kaynağı.
mask_urlgerekli mask
Türurl · image
Girdi görselinin karşılık gelen boyutlarıyla hem genişlik hem yüksekliğin tam olarak eşleşmesi gereken URL yoluyla sağlanan iç boyama maskesi.
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/v3/edit",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "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/v3/edit.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt