Ideogram V3 Edit

Unganisha

Kitambulisho cha modeli 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"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ideogram/v3/edit?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ideogram/v3/edit", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/sw/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "ideogram/v3/edit",
  "input": {
    "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"
  }
}

Piga modeli ya Ideogram V3 Edit (ideogram/v3/edit) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/ideogram/v3/edit.md

POST https://api.doitong.ru/v1/run/ideogram/v3/edit?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "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"
}

Ikiwa hali ya jibu ni "queued" au "running", piga GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 mara kwa mara hadi iwe "succeeded"; faili ziko kwenye outputs[].url. POST https://api.doitong.ru/v1/quote/ideogram/v3/edit yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Ombi hili: $ 0.06 salio za API 60 · ≈ ₽ 6.39 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

Ideogram Uhariri wa Picha #realism#typography

Inpainting inayotumia maski kwa Ideogram V3, ikijaza eneo lililofunikwa kwa maski kutokana na kidokezo

OpenAPI Markdown

Ideogram · Picha

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Bei

Bei halisi

kuanzia $ 0.03 / picha

salio za API 30 / picha · ≈ ₽ 3.20

Ombi hili: picha 1 × $ 0.06 $ 0.06 salio za API 60 · ≈ ₽ 6.39

Endesha · $ 0.06

Hutozwa tu ikifanikiwa, na kurejeshewa kiotomatiki ikishindwa.

rendering_speed chaguomsingi BALANCED

num_outputs chaguomsingi 1

Sheria za bei

Wakati rendering_speed = BALANCED: $ 0.06 / picha
Wakati rendering_speed = QUALITY: $ 0.09 / picha

Hutozwa kwa kila picha iliyozalishwa.

Endpoint ya makadirio: POST /quote/{id}

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

prompt •inahitajika

Kidokezo kinachoeleza kujaza kwa eneo la picha lililofichwa kwa maski.

image •inahitajika image_url

Dondosha faili, au

Chanzo cha uzalishaji kinachotolewa kama URL ya picha, ambapo upana na kimo lazima vilingane kikamilifu na vipimo vinavyolingana vya maski.

mask •inahitajika mask_url

Dondosha faili, au

Maski ya inpainting inayotolewa kupitia URL, ambapo upana na kimo lazima vilingane kikamilifu na vipimo vinavyolingana vya picha ya ingizo.

rendering_speed chaguomsingi BALANCED

Mpangilio wa kasi ya uonyeshaji.

num_outputs num_images chaguomsingi 1

Idadi ya picha za kuzalisha.

Ya kina images · style_preset · seed · expand_prompt · style_codes · color_palette

images image_urls

Dondosha faili, au

Picha za marejeleo ya mtindo katika umbizo la JPEG, PNG au WebP. Ukubwa wake kwa pamoja haupaswi kuzidi 10 MB.

style_preset

Mwekeo wa mtindo ambao uteuzi wake huongoza uzalishaji wa picha.

seed

Thamani ya mbegu kwa uzalishaji wa nambari nasibu.

style_codes

Misimbo ya mtindo wa picha, inayotolewa kama mifuatano ya heksadesimali yenye herufi 8 kila mmoja; usijumuishe style_reference_images na style unapotumia orodha hii.

color_palette

Paleti ya rangi inayotumika wakati wa uzalishaji. Bainisha preset kwa jina au rangi za heksadesimali wazi kupitia members, ikiwezekana pamoja na uzani.

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

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ideogram/v3/edit?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ideogram/v3/edit", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "ideogram/v3/edit",
      "input": {
        "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"
      },
      "wait_seconds": 20
    }
  }
}

Endesha ombi hili

Ufunguo wa API

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Kumbuka katika kivinjari hiki Pata ufunguo wa API

Kuhusu Ideogram V3 Edit

Hujaza eneo lililofunikwa kwa maski la picha kulingana na `prompt`. Picha (`image_url`) na maski (`mask_url`) lazima ziwe na vipimo sawa. Mtindo unaweza kuelekezwa kwa picha za rejeleo, `style_codes`, `color_palette` au `style_preset`. Kasi ya kurenda ni TURBO, BALANCED au QUALITY, na picha 1 hadi 8 zinaweza kurejeshwa.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo

image_urlssi lazima images

Ainaurl[] · image

Picha za marejeleo ya mtindo katika umbizo la JPEG, PNG au WebP. Ukubwa wake kwa pamoja haupaswi kuzidi 10 MB.

rendering_speedsi lazima

Ainaenum

ChaguomsingiBALANCED

TURBOBALANCEDQUALITY

Mpangilio wa kasi ya uonyeshaji.

color_palettesi lazima

Ainaobject

Paleti ya rangi inayotumika wakati wa uzalishaji. Bainisha preset kwa jina au rangi za heksadesimali wazi kupitia members, ikiwezekana pamoja na uzani.

color_palette.memberssi lazima

Ainaobject[]

Orodha ya washiriki wa paleti inayobainisha rangi za paleti.

color_palette.members[].rgbinahitajika

Ainaobject

Rangi ya mshiriki wa paleti iliyoonyeshwa kama RGB.

color_palette.members[].color_weightsi lazima

Ainanumber | null

Chaguomsingi0.5

0.05 – 1

Uzani uliowekwa kwa rangi hii ndani ya paleti.

color_palette.namesi lazima

Ainaenum

EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE

Uteuzi wa preset ya paleti ya rangi.

style_codessi lazima

Ainastring[]

Misimbo ya mtindo wa picha, inayotolewa kama mifuatano ya heksadesimali yenye herufi 8 kila mmoja; usijumuishe style_reference_images na style unapotumia orodha hii.

expand_promptsi lazima

Ainaboolean

Chaguomsingitrue

Kigeuza matumizi ya MagicPrompt kwa uzalishaji wa ombi.

num_imagessi lazima num_outputs

Ainainteger

Chaguomsingi1

1 – 8

Idadi ya picha za kuzalisha.

seedsi lazima

Ainainteger | null

Thamani ya mbegu kwa uzalishaji wa nambari nasibu.

style_presetsi lazima

Ainaenum

80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE

+46 zaidi

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

Mwekeo wa mtindo ambao uteuzi wake huongoza uzalishaji wa picha.

promptinahitajika

Ainastring

Kidokezo kinachoeleza kujaza kwa eneo la picha lililofichwa kwa maski.

image_urlinahitajika image

Ainaurl · image

Chanzo cha uzalishaji kinachotolewa kama URL ya picha, ambapo upana na kimo lazima vilingane kikamilifu na vipimo vinavyolingana vya maski.

mask_urlinahitajika mask

Ainaurl · image

Maski ya inpainting inayotolewa kupitia URL, ambapo upana na kimo lazima vilingane kikamilifu na vipimo vinavyolingana vya picha ya ingizo.

inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}

Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.

Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.

Sehemu za tokeo

images: array of object {url, content_type, file_name, file_size}
seed: integerThamani ya mbegu inayotumika kwa uzalishaji wa nambari nasibu.

Miundo zaidi: Uhariri wa Picha

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/ideogram/v3/edit.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt

Tokeo lako la kwanza linaonekana hapa

Unda ombi

Endesha ombi hili

Kuhusu Ideogram V3 Edit

Vigezo

Tokeo

Tofauti nyingine za Ideogram v3

Miundo zaidi: Uhariri wa Picha