ਸਮੱਗਰੀ ਵੱਲ ਜਾਓ

Ideogram V3 Edit

ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ

ਮਾਡਲ id 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"

ਇਹ ਬੇਨਤੀ: $0.06 60 API ਕ੍ਰੈਡਿਟ · ≈ ₽6.33 ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ
Ideogram · ਚਿੱਤਰ

ਤੁਹਾਡਾ ਪਹਿਲਾ ਨਤੀਜਾ ਇੱਥੇ ਹੋਵੇਗਾ

ਹੇਠਾਂ ਬੇਨਤੀ ਬਣਾਓ ਅਤੇ ਆਪਣੀ API ਕੁੰਜੀ ਨਾਲ ਚਲਾਓ। ਆਉਟਪੁੱਟ ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਕਾਪੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਹਮੇਸ਼ਾ ਲਈ ਜਾਂ ਮੁਫ਼ਤ ਵਿੱਚ 7 ਦਿਨ ਤੱਕ ਰੱਖੇ ਜਾਂਦੇ ਹਨ।

ਰਿਕਵੈਸਟ ਬਣਾਓ

ਕੰਟਰੋਲ ਮਾਡਲ ਸਕੀਮਾ ਤੋਂ ਤਿਆਰ ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਬਦਲਾਅ ਕਰਦੇ ਹੀ ਕੋਡ ਅਤੇ ਕੀਮਤ ਅੱਪਡੇਟ ਹੋ ਜਾਂਦੇ ਹਨ।

•ਲੋੜੀਂਦਾ

ਚਿੱਤਰ ਦੇ ਮਾਸਕ ਕੀਤੇ ਖੇਤਰ ਨੂੰ ਭਰਨ ਲਈ ਪ੍ਰੌਂਪਟ।

•ਲੋੜੀਂਦਾ image_url
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

ਚਿੱਤਰ URL ਵਜੋਂ ਦਿੱਤਾ ਗਿਆ ਸਿਰਜਣਾ ਸਰੋਤ, ਜਿਸ ਦੀ ਚੌੜਾਈ ਅਤੇ ਉਚਾਈ ਦੋਵੇਂ ਮਾਸਕ ਦੇ ਸੰਬੰਧਿਤ ਮਾਪਾਂ ਦੇ ਬਿਲਕੁਲ ਬਰਾਬਰ ਹੋਣੀਆਂ ਲਾਜ਼ਮੀ ਹਨ।

•ਲੋੜੀਂਦਾ mask_url
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

URL ਰਾਹੀਂ ਦਿੱਤਾ ਗਿਆ ਇਨਪੇਂਟਿੰਗ ਮਾਸਕ, ਜਿਸ ਦੀ ਚੌੜਾਈ ਅਤੇ ਉਚਾਈ ਦੋਵੇਂ ਇਨਪੁੱਟ ਚਿੱਤਰ ਦੇ ਸੰਬੰਧਿਤ ਮਾਪਾਂ ਦੇ ਬਿਲਕੁਲ ਬਰਾਬਰ ਹੋਣੀਆਂ ਲਾਜ਼ਮੀ ਹਨ।

rendering_speed ਡਿਫ਼ਾਲਟ BALANCED

ਰੈਂਡਰਿੰਗ ਲਈ ਗਤੀ ਸੈਟਿੰਗ।

num_images ਡਿਫ਼ਾਲਟ 1

ਤਿਆਰ ਕੀਤੇ ਜਾਣ ਵਾਲੇ ਚਿੱਤਰਾਂ ਦੀ ਗਿਣਤੀ।

ਉੱਨਤ images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

JPEG, PNG ਜਾਂ WebP ਫਾਰਮੈਟਾਂ ਵਿੱਚ ਸਟਾਈਲ ਸੰਦਰਭ ਚਿੱਤਰ। ਉਨ੍ਹਾਂ ਦਾ ਮਿਲਿਆ-ਜੁਲਿਆ ਆਕਾਰ 10 MB ਤੋਂ ਵੱਧ ਨਹੀਂ ਹੋਣਾ ਚਾਹੀਦਾ।

ਸਟਾਈਲ ਪ੍ਰੀਸੈਟ, ਜਿਸ ਦੀ ਚੋਣ ਚਿੱਤਰ ਸਿਰਜਣਾ ਲਈ ਮਾਰਗਦਰਸ਼ਨ ਕਰਦੀ ਹੈ।

ਰੈਂਡਮ ਨੰਬਰ ਸਿਰਜਣਾ ਲਈ ਸੀਡ ਮੁੱਲ।

ਚਿੱਤਰ-ਸਟਾਈਲ ਕੋਡ, ਹਰ ਇੱਕ 8 ਅੱਖਰਾਂ ਵਾਲੀ ਹੈਕਸਾਡੈਸੀਮਲ ਸਤਰ ਵਜੋਂ; ਇਹ ਸੂਚੀ ਵਰਤਦੇ ਸਮੇਂ style_reference_images ਅਤੇ style ਦੋਵੇਂ ਛੱਡੋ।

ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਰੰਗ ਪੈਲੇਟ। name ਰਾਹੀਂ ਪ੍ਰੀਸੈਟ ਜਾਂ members ਰਾਹੀਂ ਸਪਸ਼ਟ ਹੈਕਸਾਡੈਸੀਮਲ ਰੰਗ ਦਿਓ, ਅਤੇ ਚਾਹੋ ਤਾਂ weights ਸ਼ਾਮਲ ਕਰੋ।

POST /run/ideogram/v3/edit?wait=20 ਕੋਟ → $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"

ਇਹ ਬੇਨਤੀ ਚਲਾਓ

ਤੁਹਾਡੀ key ਇਸ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਰਹਿੰਦੀ ਹੈ: ਇਹ ਸਿਰਫ਼ Doitong API ਨੂੰ ਭੇਜੀ ਜਾਂਦੀ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਤਾਂ ਹੀ (localStorage) ਵਿੱਚ ਸੁਰੱਖਿਅਤ ਹੁੰਦੀ ਹੈ ਜੇ ਤੁਸੀਂ Remember ਚੁਣੋ। API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

Ideogram V3 Edit ਬਾਰੇ

ਇੱਕ ਚਿੱਤਰ ਦੇ ਮਾਸਕ ਕੀਤੇ ਖੇਤਰ ਨੂੰ `prompt` ਦੇ ਅਨੁਸਾਰ ਭਰਦਾ ਹੈ। ਚਿੱਤਰ (`image_url`) ਅਤੇ ਮਾਸਕ (`mask_url`) ਦੇ ਮਾਪ ਇਕੋ ਜਿਹੇ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ। ਰੈਫ਼ਰੈਂਸ ਚਿੱਤਰਾਂ, `style_codes`, `color_palette` ਜਾਂ `style_preset` ਰਾਹੀਂ ਸਟਾਈਲ ਨੂੰ ਨਿਰਦੇਸ਼ਿਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਰੈਂਡਰਿੰਗ ਗਤੀ TURBO, BALANCED ਜਾਂ QUALITY ਹੁੰਦੀ ਹੈ ਅਤੇ 1 ਤੋਂ 8 ਚਿੱਤਰ ਵਾਪਸ ਕੀਤੇ ਜਾ ਸਕਦੇ ਹਨ।

ਪੈਰਾਮੀਟਰ

ਕੈਨੋਨਿਕਲ ਨਾਮ ਜਾਂ ਨੇਟਿਵ ਨਾਮ ਵਿੱਚੋਂ ਕੋਈ ਇੱਕ ਭੇਜੋ, ਦੋਵੇਂ ਨਹੀਂ। ਕੈਨੋਨਿਕਲ ਨਾਮ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
image_urlsਵਿਕਲਪਿਕ images
ਕਿਸਮurl[] · image
JPEG, PNG ਜਾਂ WebP ਫਾਰਮੈਟਾਂ ਵਿੱਚ ਸਟਾਈਲ ਸੰਦਰਭ ਚਿੱਤਰ। ਉਨ੍ਹਾਂ ਦਾ ਮਿਲਿਆ-ਜੁਲਿਆ ਆਕਾਰ 10 MB ਤੋਂ ਵੱਧ ਨਹੀਂ ਹੋਣਾ ਚਾਹੀਦਾ।
rendering_speedਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟBALANCED
TURBOBALANCEDQUALITY
ਰੈਂਡਰਿੰਗ ਲਈ ਗਤੀ ਸੈਟਿੰਗ।
color_paletteਵਿਕਲਪਿਕ
ਕਿਸਮobject
ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਰੰਗ ਪੈਲੇਟ। name ਰਾਹੀਂ ਪ੍ਰੀਸੈਟ ਜਾਂ members ਰਾਹੀਂ ਸਪਸ਼ਟ ਹੈਕਸਾਡੈਸੀਮਲ ਰੰਗ ਦਿਓ, ਅਤੇ ਚਾਹੋ ਤਾਂ weights ਸ਼ਾਮਲ ਕਰੋ।
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 ਦੋਵੇਂ ਛੱਡੋ।
expand_promptਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟtrue
ਬੇਨਤੀ ਸਿਰਜਣਾ ਲਈ MagicPrompt ਵਰਤੋਂ ਟੌਗਲ।
num_imagesਵਿਕਲਪਿਕ num_outputs
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ1
1 – 8
ਤਿਆਰ ਕੀਤੇ ਜਾਣ ਵਾਲੇ ਚਿੱਤਰਾਂ ਦੀ ਗਿਣਤੀ।
seedਵਿਕਲਪਿਕ
ਕਿਸਮinteger | null
ਰੈਂਡਮ ਨੰਬਰ ਸਿਰਜਣਾ ਲਈ ਸੀਡ ਮੁੱਲ।
style_presetਵਿਕਲਪਿਕ
ਕਿਸਮenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 ਹੋਰCOLORING_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
ਸਟਾਈਲ ਪ੍ਰੀਸੈਟ, ਜਿਸ ਦੀ ਚੋਣ ਚਿੱਤਰ ਸਿਰਜਣਾ ਲਈ ਮਾਰਗਦਰਸ਼ਨ ਕਰਦੀ ਹੈ।
promptਲੋੜੀਂਦਾ
ਕਿਸਮstring
ਚਿੱਤਰ ਦੇ ਮਾਸਕ ਕੀਤੇ ਖੇਤਰ ਨੂੰ ਭਰਨ ਲਈ ਪ੍ਰੌਂਪਟ।
image_urlਲੋੜੀਂਦਾ image
ਕਿਸਮurl · image
ਚਿੱਤਰ URL ਵਜੋਂ ਦਿੱਤਾ ਗਿਆ ਸਿਰਜਣਾ ਸਰੋਤ, ਜਿਸ ਦੀ ਚੌੜਾਈ ਅਤੇ ਉਚਾਈ ਦੋਵੇਂ ਮਾਸਕ ਦੇ ਸੰਬੰਧਿਤ ਮਾਪਾਂ ਦੇ ਬਿਲਕੁਲ ਬਰਾਬਰ ਹੋਣੀਆਂ ਲਾਜ਼ਮੀ ਹਨ।
mask_urlਲੋੜੀਂਦਾ mask
ਕਿਸਮurl · image
URL ਰਾਹੀਂ ਦਿੱਤਾ ਗਿਆ ਇਨਪੇਂਟਿੰਗ ਮਾਸਕ, ਜਿਸ ਦੀ ਚੌੜਾਈ ਅਤੇ ਉਚਾਈ ਦੋਵੇਂ ਇਨਪੁੱਟ ਚਿੱਤਰ ਦੇ ਸੰਬੰਧਿਤ ਮਾਪਾਂ ਦੇ ਬਿਲਕੁਲ ਬਰਾਬਰ ਹੋਣੀਆਂ ਲਾਜ਼ਮੀ ਹਨ।
ਲੋੜੀਂਦਾ ਕੈਨੋਨਿਕਲ ਨਾਮ, ਇਹ ਵੀ ਸਵੀਕਾਰਿਆ ਜਾਂਦਾ ਹੈ

ਫ਼ਾਈਲ ਪੈਰਾਮੀਟਰ ਜਨਤਕ https:// URL, 10 MB ਤੱਕ ਦਾ data: URI, ਜਾਂ ਅੱਪਲੋਡ ਦੇ file_url ਨੂੰ ਸਵੀਕਾਰਦੇ ਹਨ। ਫ਼ਾਈਲਾਂ

ਆਉਟਪੁੱਟ

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"
  }
}
ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡੀ ਚੋਣਹਰ 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ਰੈਂਡਮ ਨੰਬਰ ਸਿਰਜਣਾ ਲਈ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਸੀਡ ਮੁੱਲ।

ਹੋਰ ਮਾਡਲ: ਚਿੱਤਰ ਸੰਪਾਦਨ

AI ਏਜੰਟਾਂ ਲਈ: ਇਹ ਪੰਨਾ Markdown ਵਜੋਂ ਇੱਥੇ ਹੈ https://doitong.com/pa/developers/models/ideogram/v3/edit.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt