Lompat ke konten

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 di halaman ini

Dapatkan kunci API
Ideogram Pengeditan Gambar Input referensi #character-consistency

Pengeditan bermasker Ideogram V3 pada gambar sambil mempertahankan identitas karakter yang direferensikan

Ideogram · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Prompt yang mendeskripsikan fill untuk area gambar yang bermask.

•wajib image_url
Jatuhkan file, atau

Sumber pembuatan yang diberikan sebagai URL gambar, dengan lebar dan tinggi yang wajib sama persis dengan dimensi mask yang sesuai.

•wajib mask_url
Jatuhkan file, atau

Mask inpainting yang diberikan melalui URL, dengan lebar dan tinggi yang wajib sama persis dengan dimensi gambar input yang sesuai.

•wajib
Jatuhkan file, atau

Gambar referensi karakter dalam format JPEG, PNG, atau WebP, dengan batas gabungan 10 MB untuk semua referensi karakter. Saat ini hanya 1 gambar yang didukung; gambar tambahan diabaikan.

rendering_speed bawaan BALANCED

Pengaturan kecepatan untuk rendering.

num_images bawaan 1

Jumlah gambar yang dihasilkan.

Lanjutan images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette
image_urls
Jatuhkan file, atau

Gambar referensi gaya dalam format JPEG, PNG, atau WebP. Ukuran gabungannya tidak boleh melebihi 10 MB.

Jatuhkan file, atau

Mask referensi karakter dalam format JPEG, PNG, atau WebP; ukuran total semua referensi karakter tidak boleh melebihi 10 MB. Saat ini hanya 1 mask yang digunakan; mask tambahan diabaikan.

Nilai seed untuk pembuatan angka acak.

Kode gaya gambar, diberikan sebagai string heksadesimal yang masing-masing terdiri dari 8 karakter; jangan gunakan style_reference_images dan style saat menggunakan daftar ini.

Palet warna yang digunakan selama pembuatan. Tentukan preset melalui name atau warna heksadesimal eksplisit melalui members, yang secara opsional dapat menyertakan bobot.

POST /run/ideogram/character/edit?wait=20 estimasi 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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Ideogram V3 Character Edit

Mengisi area bermasker pada `image_url` menggunakan `mask_url` (keduanya harus memiliki dimensi identik), `prompt`, dan referensi karakter dalam `reference_image_urls` (1 gambar digunakan). Berguna untuk mengubah pose, ekspresi atau pakaian. Mendukung referensi gaya opsional, `rendering_speed` dan hingga 8 output.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlsopsional images
Tipeurl[] · image
Gambar referensi gaya dalam format JPEG, PNG, atau WebP. Ukuran gabungannya tidak boleh melebihi 10 MB.
rendering_speedopsional
Tipeenum
BawaanBALANCED
TURBOBALANCEDQUALITY
Pengaturan kecepatan untuk rendering.
color_paletteopsional
Tipeobject
Palet warna yang digunakan selama pembuatan. Tentukan preset melalui name atau warna heksadesimal eksplisit melalui members, yang secara opsional dapat menyertakan bobot.
color_palette.membersopsional
Tipeobject[]
Daftar anggota palet yang menentukan warna palet.
color_palette.members[].rgbwajib
Tipeobject
Warna anggota palet yang dinyatakan sebagai RGB.
color_palette.members[].color_weightopsional
Tipenumber | null
Bawaan0.5
0,05 – 1
Bobot yang ditetapkan ke warna ini dalam palet.
color_palette.nameopsional
Tipeenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Pilihan preset untuk palet warna.
style_codesopsional
Tipestring[]
Kode gaya gambar, diberikan sebagai string heksadesimal yang masing-masing terdiri dari 8 karakter; jangan gunakan style_reference_images dan style saat menggunakan daftar ini.
expand_promptopsional
Tipeboolean
Bawaantrue
Sakelar penggunaan MagicPrompt untuk pembuatan permintaan.
num_imagesopsional num_outputs
Tipeinteger
Bawaan1
1 – 8
Jumlah gambar yang dihasilkan.
seedopsional
Tipeinteger | null
Nilai seed untuk pembuatan angka acak.
promptwajib
Tipestring
Prompt yang mendeskripsikan fill untuk area gambar yang bermask.
image_urlwajib image
Tipeurl · image
Sumber pembuatan yang diberikan sebagai URL gambar, dengan lebar dan tinggi yang wajib sama persis dengan dimensi mask yang sesuai.
mask_urlwajib mask
Tipeurl · image
Mask inpainting yang diberikan melalui URL, dengan lebar dan tinggi yang wajib sama persis dengan dimensi gambar input yang sesuai.
reference_image_urlswajib
Tipeurl[] · image
Gambar referensi karakter dalam format JPEG, PNG, atau WebP, dengan batas gabungan 10 MB untuk semua referensi karakter. Saat ini hanya 1 gambar yang didukung; gambar tambahan diabaikan.
reference_mask_urlsopsional
Tipeurl[] · image
Mask referensi karakter dalam format JPEG, PNG, atau WebP; ukuran total semua referensi karakter tidak boleh melebihi 10 MB. Saat ini hanya 1 mask yang digunakan; mask tambahan diabaikan.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
images
array of object {url, content_type, file_name, file_size}
seed
integerNilai seed yang digunakan untuk pembuatan angka acak.

Model lainnya: Pengeditan Gambar

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