Langkau ke kandungan

Ideogram V3 Character Edit

Integrasikan

ID model 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"

Permintaan ini: $0.15 150 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Ideogram Penyuntingan Imej Input rujukan #character-consistency

Penyuntingan bermask Ideogram V3 pada imej sambil mengekalkan identiti watak rujukan

Ideogram · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Prompt yang menerangkan fill untuk kawasan bertopeng imej.

•diperlukan image_url
Lepaskan fail, atau

Sumber penjanaan yang dibekalkan sebagai URL imej, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan topeng.

•diperlukan mask_url
Lepaskan fail, atau

Topeng inpainting yang dibekalkan melalui URL, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan imej input.

•diperlukan
Lepaskan fail, atau

Imej rujukan watak dalam format JPEG, PNG atau WebP, dengan had gabungan 10 MB untuk semua rujukan watak. Sokongan kini terhad kepada 1 imej; imej tambahan diabaikan.

rendering_speed lalai BALANCED

Tetapan kelajuan untuk pemaparan.

num_images lalai 1

Bilangan imej yang hendak dihasilkan.

Lanjutan images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette
image_urls
Lepaskan fail, atau

Imej rujukan gaya dalam format JPEG, PNG atau WebP. Saiz gabungannya tidak boleh melebihi 10 MB.

Lepaskan fail, atau

Topeng rujukan watak dalam format JPEG, PNG atau WebP; jumlah saiz semua rujukan watak tidak boleh melebihi 10 MB. Hanya 1 topeng digunakan pada masa ini; topeng tambahan diabaikan.

Nilai seed untuk penjanaan nombor rawak.

Kod gaya imej, dibekalkan sebagai rentetan heksadesimal 8 aksara setiap satu; jangan sertakan style_reference_images dan style apabila menggunakan senarai ini.

Palet warna yang digunakan semasa penjanaan. Nyatakan pratetap melalui name atau warna heksadesimal secara jelas melalui members, dengan berat pilihan.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Ideogram V3 Character Edit

Mengisi kawasan bermask pada `image_url` menggunakan `mask_url` (kedua-duanya mesti mempunyai dimensi yang sama), `prompt` dan rujukan watak dalam `reference_image_urls` (1 imej digunakan). Berguna untuk menukar pose, ekspresi atau pakaian. Menyokong rujukan gaya pilihan, `rendering_speed` dan sehingga 8 output.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urlspilihan images
Jenisurl[] · image
Imej rujukan gaya dalam format JPEG, PNG atau WebP. Saiz gabungannya tidak boleh melebihi 10 MB.
rendering_speedpilihan
Jenisenum
LalaiBALANCED
TURBOBALANCEDQUALITY
Tetapan kelajuan untuk pemaparan.
color_palettepilihan
Jenisobject
Palet warna yang digunakan semasa penjanaan. Nyatakan pratetap melalui name atau warna heksadesimal secara jelas melalui members, dengan berat pilihan.
color_palette.memberspilihan
Jenisobject[]
Senarai ahli palet yang menentukan warna palet.
color_palette.members[].rgbdiperlukan
Jenisobject
Warna ahli palet yang dinyatakan sebagai RGB.
color_palette.members[].color_weightpilihan
Jenisnumber | null
Lalai0.5
0.05 – 1
Berat yang diberikan kepada warna ini dalam palet.
color_palette.namepilihan
Jenisenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Pilihan pratetap untuk palet warna.
style_codespilihan
Jenisstring[]
Kod gaya imej, dibekalkan sebagai rentetan heksadesimal 8 aksara setiap satu; jangan sertakan style_reference_images dan style apabila menggunakan senarai ini.
expand_promptpilihan
Jenisboolean
Lalaitrue
Suis penggunaan MagicPrompt untuk penjanaan permintaan.
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 8
Bilangan imej yang hendak dihasilkan.
seedpilihan
Jenisinteger | null
Nilai seed untuk penjanaan nombor rawak.
promptdiperlukan
Jenisstring
Prompt yang menerangkan fill untuk kawasan bertopeng imej.
image_urldiperlukan image
Jenisurl · image
Sumber penjanaan yang dibekalkan sebagai URL imej, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan topeng.
mask_urldiperlukan mask
Jenisurl · image
Topeng inpainting yang dibekalkan melalui URL, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan imej input.
reference_image_urlsdiperlukan
Jenisurl[] · image
Imej rujukan watak dalam format JPEG, PNG atau WebP, dengan had gabungan 10 MB untuk semua rujukan watak. Sokongan kini terhad kepada 1 imej; imej tambahan diabaikan.
reference_mask_urlspilihan
Jenisurl[] · image
Topeng rujukan watak dalam format JPEG, PNG atau WebP; jumlah saiz semua rujukan watak tidak boleh melebihi 10 MB. Hanya 1 topeng digunakan pada masa ini; topeng tambahan diabaikan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, content_type, file_name, file_size}
seed
integerNilai seed yang digunakan untuk penjanaan nombor rawak.

Lebih banyak model: Penyuntingan Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/ideogram/character/edit.md. Semua model dan panduan: https://doitong.com/developers/llms.txt