Ideogram V3 Character Edit

Integra

Id tal-mudell ideogram/character/edit

# 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/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",
    "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"

const API = "https://api.doitong.com/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/character/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",
    "reference_image_urls": [
      "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.com/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",
    "reference_image_urls": [
        "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/character/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/mt/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "ideogram/character/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",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }
}

Ċempel il-mudell Ideogram V3 Character Edit (ideogram/character/edit) permezz tad-Doitong API. Dokumentazzjoni għall-aġenti: https://doitong.com/mt/developers/models/ideogram/character/edit.md

POST https://api.doitong.com/v1/run/ideogram/character/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",
  "reference_image_urls": [
    "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  ]
}

Jekk l-istatus tar-rispons huwa "queued" jew "running", agħmel polling fuq GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 sakemm ikun "succeeded"; il-fajls jinsabu f’outputs[].url. POST https://api.doitong.com/v1/quote/ideogram/character/edit bl-istess body jirritorna l-prezz eżatt qabel it-tħaddim.

Din it-talba: $0.15 150 krediti tal-API Ħaddmu f’din il-paġna

Ikseb ċavetta API

Ideogram Editjar tal-immaġini Inputs ta’ referenza #character-consistency

Editjar b’maskra ta’ Ideogram V3 fuq immaġni filwaqt li jippreserva l-identità tal-karattru referenzjat

OpenAPI Markdown

Ideogram · Immaġni

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Prezz

Prezz eżatt

minn $0.10 / immaġni

100 krediti tal-API / immaġni

Din it-talba: 1 immaġni × $0.15 $0.15 150 krediti tal-API

Ħaddem · $0.15

Iċċarġjat biss jekk jirnexxi, u rimborżat awtomatikament jekk ifalli.

rendering_speed prestabbilit BALANCED

num_outputs prestabbilit 1

Regoli tal-prezz

Meta rendering_speed = BALANCED: $0.15 / immaġni
Meta rendering_speed = QUALITY: $0.20 / immaġni

Iċċarġjat għal kull immaġni ġġenerata.

Endpoint tal-kwotazzjoni: POST /quote/{id}

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

prompt •meħtieġ

Prompt li jiddeskrivi l-mili għar-reġjun mgħotti tal-immaġni.

image •meħtieġ image_url

Waqqa’ fajl, jew

Sors tal-ġenerazzjoni pprovdut bħala URL tal-immaġni, fejn kemm il-wisa’ kif ukoll l-għoli għandhom ikunu eżattament ugwali għad-dimensjonijiet korrispondenti tal-maskra.

mask •meħtieġ mask_url

Waqqa’ fajl, jew

Maskra tal-inpainting ipprovduta permezz ta’ URL, fejn kemm il-wisa’ kif ukoll l-għoli għandhom ikunu eżattament ugwali għad-dimensjonijiet korrispondenti tal-immaġni input.

reference_image_urls •meħtieġ

Waqqa’ fajl, jew

Immaġnijiet ta’ referenza tal-karattri f’format JPEG, PNG jew WebP, b’limitu magħqud ta’ 10 MB għar-referenzi kollha tal-karattri. Bħalissa hija appoġġjata immaġni waħda biss; immaġnijiet addizzjonali jiġu injorati.

rendering_speed prestabbilit BALANCED

Issettjar tal-veloċità għar-rendering.

num_outputs num_images prestabbilit 1

Għadd ta’ immaġnijiet li għandhom jiġu prodotti.

Avvanzat images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette

images image_urls

Waqqa’ fajl, jew

Immaġnijiet ta’ referenza tal-istil f’format JPEG, PNG jew WebP. Id-daqs magħqud tagħhom ma jistax jaqbeż 10 MB.

reference_mask_urls

Waqqa’ fajl, jew

Maskri ta’ referenza tal-karattri f’format JPEG, PNG jew WebP; id-daqs totali tar-referenzi kollha tal-karattri ma jistax jaqbeż 10 MB. Bħalissa tintuża maskra waħda biss, u maskri addizzjonali jiġu injorati.

seed

Valur tas-seed għall-ġenerazzjoni ta’ numri każwali.

style_codes

Kodiċijiet tal-istil tal-immaġni, ipprovduti bħala strings eżadeċimali ta’ 8 karattri kull wieħed; ħalli barra kemm style_reference_images kif ukoll style meta tuża din il-lista.

color_palette

Paletta tal-kuluri użata waqt il-ġenerazzjoni. Speċifika preset permezz tal-isem jew kuluri espliċiti eżadeċimali permezz tal-membri, b’piżijiet mhux obbligatorji.

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

const API = "https://api.doitong.com/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/character/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",
    "reference_image_urls": [
      "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.com/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",
    "reference_image_urls": [
        "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/character/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/character/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",
        "reference_image_urls": [
          "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
        ]
      },
      "wait_seconds": 20
    }
  }
}

Ħaddem din it-talba

Ċavetta API

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ftakar f’dan il-browser Ikseb ċavetta API

Dwar Ideogram V3 Character Edit

Jimla b’mod inpainting żona mmasked ta’ `image_url` billi juża `mask_url` (it-tnejn irid ikollhom dimensjonijiet identiċi), `prompt`, u referenza tal-karattru f’`reference_image_urls` (tintuża immaġni waħda). Utli biex jinbidlu l-poża, l-espressjoni jew il-ħwejjeġ. Jappoġġja referenzi ta’ stil fakultattivi, `rendering_speed` u sa 8 outputs.

Parametri

Ibgħat jew l-isem kanoniku jew l-isem nattiv, mhux it-tnejn. Ismijiet kanoniċi

IsemTip PrestabbilitPermess Deskrizzjoni

image_urlsmhux obbligatorju images

Tipurl[] · image

Immaġnijiet ta’ referenza tal-istil f’format JPEG, PNG jew WebP. Id-daqs magħqud tagħhom ma jistax jaqbeż 10 MB.

rendering_speedmhux obbligatorju

Tipenum

PrestabbilitBALANCED

TURBOBALANCEDQUALITY

Issettjar tal-veloċità għar-rendering.

color_palettemhux obbligatorju

Tipobject

Paletta tal-kuluri użata waqt il-ġenerazzjoni. Speċifika preset permezz tal-isem jew kuluri espliċiti eżadeċimali permezz tal-membri, b’piżijiet mhux obbligatorji.

color_palette.membersmhux obbligatorju

Tipobject[]

Lista tal-membri tal-paletta li tiddefinixxi l-kuluri tagħha.

color_palette.members[].rgbmeħtieġ

Tipobject

Kulur tal-membru tal-paletta espress bħala RGB.

color_palette.members[].color_weightmhux obbligatorju

Tipnumber | null

Prestabbilit0.5

0.05 – 1

Piż assenjat lil dan il-kulur fil-paletta.

color_palette.namemhux obbligatorju

Tipenum

EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE

Għażla tal-preset għall-paletta tal-kuluri.

style_codesmhux obbligatorju

Tipstring[]

Kodiċijiet tal-istil tal-immaġni, ipprovduti bħala strings eżadeċimali ta’ 8 karattri kull wieħed; ħalli barra kemm style_reference_images kif ukoll style meta tuża din il-lista.

expand_promptmhux obbligatorju

Tipboolean

Prestabbilittrue

Kontroll tal-użu ta’ MagicPrompt għall-ġenerazzjoni tat-talba.

num_imagesmhux obbligatorju num_outputs

Tipinteger

Prestabbilit1

1 – 8

Għadd ta’ immaġnijiet li għandhom jiġu prodotti.

seedmhux obbligatorju

Tipinteger | null

Valur tas-seed għall-ġenerazzjoni ta’ numri każwali.

promptmeħtieġ

Tipstring

Prompt li jiddeskrivi l-mili għar-reġjun mgħotti tal-immaġni.

image_urlmeħtieġ image

Tipurl · image

Sors tal-ġenerazzjoni pprovdut bħala URL tal-immaġni, fejn kemm il-wisa’ kif ukoll l-għoli għandhom ikunu eżattament ugwali għad-dimensjonijiet korrispondenti tal-maskra.

mask_urlmeħtieġ mask

Tipurl · image

Maskra tal-inpainting ipprovduta permezz ta’ URL, fejn kemm il-wisa’ kif ukoll l-għoli għandhom ikunu eżattament ugwali għad-dimensjonijiet korrispondenti tal-immaġni input.

reference_image_urlsmeħtieġ

Tipurl[] · image

reference_mask_urlsmhux obbligatorju

Tipurl[] · image

meħtieġ Isem kanoniku, aċċettat ukoll

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/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": 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",
    "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",
    "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"
  }
}

Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.

L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.

Oqsma tal-output