Pāriet uz saturu

Ideogram V3 Character

Integrēt

Modeļa id 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"

Šis pieprasījums: 0,15 $ 150 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Ideogram Attēlu rediģēšana Atsauču ievades #character-consistency

Ideogram V3 ģenerēšana, kas saglabā tēla konsekvenci, izmantojot atsauces attēlu

Ideogram · Attēls

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts

Uzvedne, kas apraksta attēla maskētā apgabala aizpildījumu.

•obligāts
Nometiet failu vai

Rakstzīmju atsauces attēli JPEG, PNG vai WebP formātā; visu rakstzīmju atsauču kopējais ierobežojums ir 10 MB. Pašlaik tiek atbalstīts tikai 1 attēls; papildu attēli tiek ignorēti.

rendering_speed noklusējums BALANCED

Renderēšanas ātruma iestatījums.

image_size noklusējums square_hd

Izvades attēlam izmantojamā izšķirtspēja.

num_images noklusējums 1

Ģenerējamo attēlu skaits.

Papildu negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
noklusējums

Norādiet nevēlamo attēla saturu; galvenās uzvednes aprakstiem ir prioritāte pār šiem negatīvās uzvednes aprakstiem.

image_urls
Nometiet failu vai

Stila atsauces attēli JPEG, PNG vai WebP formātā. To kopējais izmērs nedrīkst pārsniegt 10 MB.

Nometiet failu vai

Rakstzīmju atsauces maskas JPEG, PNG vai WebP formātā; kopējais izmērs nedrīkst pārsniegt 10 MB. Pašlaik tiek izmantota tikai 1 maska; papildu maskas tiek ignorētas.

style noklusējums AUTO

Ģenerēšanai izmantotais stila tips; tas nav savienojams ar style_codes.

Nejaušo skaitļu ģenerēšanas sēklas vērtība.

Attēla stila kodi, kas sniegti kā 8 rakstzīmju heksadecimālas virknes; izmantojot šo sarakstu, neiekļaujiet ne style_reference_images, ne style.

Ģenerēšanas laikā izmantotā krāsu palete. Norādiet iepriekšiestatījumu, izmantojot name, vai precīzas heksadecimālās krāsas, izmantojot members; pēc izvēles var iekļaut svarus.

POST /run/ideogram/character?wait=20 cena → 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"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Ideogram V3 Character

Ģenerē tēla attēlus no `prompt` un atsauces `reference_image_urls` (tiek izmantots tikai 1 attēls). Neobligātās stila atsauces ievieto `image_urls`, bet lielākai kontrolei izmanto `style_codes`, `color_palette` un `reference_mask_urls`. `rendering_speed` ir TURBO, BALANCED vai QUALITY, bet `num_images` sasniedz 8.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlsneobligāts images
Tipsurl[] · image
Stila atsauces attēli JPEG, PNG vai WebP formātā. To kopējais izmērs nedrīkst pārsniegt 10 MB.
rendering_speedneobligāts
Tipsenum
NoklusējumsBALANCED
TURBOBALANCEDQUALITY
Renderēšanas ātruma iestatījums.
color_paletteneobligāts
Tipsobject
Ģenerēšanas laikā izmantotā krāsu palete. Norādiet iepriekšiestatījumu, izmantojot name, vai precīzas heksadecimālās krāsas, izmantojot members; pēc izvēles var iekļaut svarus.
color_palette.membersneobligāts
Tipsobject[]
Paletes elementu saraksts, kas definē paletes krāsas.
color_palette.members[].rgbobligāts
Tipsobject
Paletes elementa krāsa, izteikta RGB formātā.
color_palette.members[].color_weightneobligāts
Tipsnumber | null
Noklusējums0.5
0,05 – 1
Šai krāsai paletē piešķirtais svars.
color_palette.nameneobligāts
Tipsenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Krāsu paletes iepriekšiestatījuma izvēle.
style_codesneobligāts
Tipsstring[]
Attēla stila kodi, kas sniegti kā 8 rakstzīmju heksadecimālas virknes; izmantojot šo sarakstu, neiekļaujiet ne style_reference_images, ne style.
styleneobligāts
Tipsenum
NoklusējumsAUTO
AUTOREALISTICFICTION
Ģenerēšanai izmantotais stila tips; tas nav savienojams ar style_codes.
expand_promptneobligāts
Tipsboolean
Noklusējumstrue
MagicPrompt lietojuma pārslēgs pieprasījumu ģenerēšanai.
num_imagesneobligāts num_outputs
Tipsinteger
Noklusējums1
1 – 8
Ģenerējamo attēlu skaits.
seedneobligāts
Tipsinteger | null
Nejaušo skaitļu ģenerēšanas sēklas vērtība.
promptobligāts
Tipsstring
Uzvedne, kas apraksta attēla maskētā apgabala aizpildījumu.
image_sizeneobligāts
Tipsobject
Noklusējumssquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Izvades attēlam izmantojamā izšķirtspēja.
negative_promptneobligāts
Tipsstring
Noklusējums
Norādiet nevēlamo attēla saturu; galvenās uzvednes aprakstiem ir prioritāte pār šiem negatīvās uzvednes aprakstiem.
reference_image_urlsobligāts
Tipsurl[] · image
Rakstzīmju atsauces attēli JPEG, PNG vai WebP formātā; visu rakstzīmju atsauču kopējais ierobežojums ir 10 MB. Pašlaik tiek atbalstīts tikai 1 attēls; papildu attēli tiek ignorēti.
reference_mask_urlsneobligāts
Tipsurl[] · image
Rakstzīmju atsauces maskas JPEG, PNG vai WebP formātā; kopējais izmērs nedrīkst pārsniegt 10 MB. Pašlaik tiek izmantota tikai 1 maska; papildu maskas tiek ignorētas.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
images
array of object {url, content_type, file_name, file_size}
seed
integerNejaušo skaitļu ģenerēšanai izmantotā sēklas vērtība.

Vairāk modeļu: Attēlu rediģēšana

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/ideogram/character.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt