Langkau ke kandungan

Ideogram V3 Character

Integrasikan

ID model ideogram/character
# 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?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",
    "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

Penjanaan Ideogram V3 yang mengekalkan konsistensi watak menggunakan imej 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
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.

image_size lalai square_hd

Resolusi yang digunakan untuk imej output.

num_images lalai 1

Bilangan imej yang hendak dihasilkan.

Lanjutan negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
lalai

Nyatakan kandungan imej yang tidak diingini, tertakluk kepada keutamaan penerangan prompt utama berbanding penerangan prompt negatif ini.

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.

style lalai AUTO

Jenis gaya yang digunakan untuk penjanaan; tidak boleh digunakan bersama style_codes.

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?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?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",
    "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

Menjana imej watak daripada `prompt` serta rujukan dalam `reference_image_urls` (hanya 1 imej digunakan). Rujukan gaya pilihan dimasukkan dalam `image_urls`, dengan `style_codes`, `color_palette` dan `reference_mask_urls` untuk kawalan lebih terperinci. `rendering_speed` ialah TURBO, BALANCED atau QUALITY, dan `num_images` sehingga 8.

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.
stylepilihan
Jenisenum
LalaiAUTO
AUTOREALISTICFICTION
Jenis gaya yang digunakan untuk penjanaan; tidak boleh digunakan bersama style_codes.
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_sizepilihan
Jenisobject
Lalaisquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolusi yang digunakan untuk imej output.
negative_promptpilihan
Jenisstring
Lalai
Nyatakan kandungan imej yang tidak diingini, tertakluk kepada keutamaan penerangan prompt utama berbanding penerangan prompt negatif ini.
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",
  "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",
    "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.md. Semua model dan panduan: https://doitong.com/developers/llms.txt