Léim chuig an ábhar

Ideogram V3 Character

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: $0.15 150 gcreidmheas API Rith ar an leathanach seo

Faigh eochair API
Ideogram Eagarthóireacht Íomhá Ionchuir tagartha #character-consistency

Giniúint Ideogram V3 a choinníonn carachtar comhsheasmhach ag úsáid íomhá thagartha

Ideogram · Íomhá

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach

Leid ina ndéantar cur síos ar an líonadh do réigiún mhasctha na híomhá.

•riachtanach
Scaoil comhad, nó

Íomhánna tagartha carachtair i bhformáid JPEG, PNG nó WebP, le teorainn chomhcheangailte 10 MB ar gach tagairt charachtair. Tá an tacaíocht teoranta faoi láthair d’íomhá amháin; déantar neamhaird d’íomhánna breise.

rendering_speed réamhshocrú BALANCED

Socrú luais don rindreáil.

image_size réamhshocrú square_hd

Taifeach atá le húsáid don íomhá aschuir.

num_images réamhshocrú 1

Líon na n-íomhánna le táirgeadh.

Ardleibhéal negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
réamhshocrú

Sonraigh ábhar íomhá nach dteastaíonn, agus tosaíocht ag tuairiscí na príomhleide ar na tuairiscí diúltacha seo.

image_urls
Scaoil comhad, nó

Íomhánna tagartha stíle i bhformáid JPEG, PNG nó WebP. Ní ceadmhach dá méid comhcheangailte dul thar 10 MB.

Scaoil comhad, nó

Maisc tagartha carachtair i bhformáid JPEG, PNG nó WebP; ní ceadmhach don mhéid iomlán thar gach tagairt charachtair dul thar 10 MB. Ní úsáidtear ach 1 masc faoi láthair; déantar neamhaird d’aon mhaisc bhreise.

style réamhshocrú AUTO

Cineál stíle a úsáidtear don ghiniúint; níl sé comhoiriúnach le style_codes.

Luach síl le haghaidh giniúint uimhreacha randamacha.

Cóid stíle íomhá, soláthraithe mar theaghráin heicsidheachúlacha 8 gcarachtar an ceann; ná húsáid style_reference_images ná style agus an liosta seo á úsáid.

Pailéad dathanna a úsáidtear le linn na giniúna. Sonraigh réamhshocrú trí ainm nó dathanna heicsidheachúlacha sainráite trí bhaill, agus meáchain san áireamh go roghnach.

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

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Ideogram V3 Character

Gineann sé íomhánna de charachtar ó `prompt` móide tagairt in `reference_image_urls` (ní úsáidtear ach 1 íomhá). Cuirtear tagairtí stíle roghnacha in `image_urls`, le `style_codes`, `color_palette` agus `reference_mask_urls` le haghaidh níos mó smachta. Is é TURBO, BALANCED nó QUALITY `rendering_speed`, agus téann `num_images` suas go 8.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
image_urlsroghnach images
Cineálurl[] · image
Íomhánna tagartha stíle i bhformáid JPEG, PNG nó WebP. Ní ceadmhach dá méid comhcheangailte dul thar 10 MB.
rendering_speedroghnach
Cineálenum
RéamhshocrúBALANCED
TURBOBALANCEDQUALITY
Socrú luais don rindreáil.
color_paletteroghnach
Cineálobject
Pailéad dathanna a úsáidtear le linn na giniúna. Sonraigh réamhshocrú trí ainm nó dathanna heicsidheachúlacha sainráite trí bhaill, agus meáchain san áireamh go roghnach.
color_palette.membersroghnach
Cineálobject[]
Liosta ball an phailéid a shainíonn dathanna an phailéid.
color_palette.members[].rgbriachtanach
Cineálobject
Dath bhall an phailéid léirithe mar RGB.
color_palette.members[].color_weightroghnach
Cineálnumber | null
Réamhshocrú0.5
0.05 – 1
Meáchan sannta don dath seo laistigh den phailéad.
color_palette.nameroghnach
Cineálenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Rogha réamhshocraithe don phailéad dathanna.
style_codesroghnach
Cineálstring[]
Cóid stíle íomhá, soláthraithe mar theaghráin heicsidheachúlacha 8 gcarachtar an ceann; ná húsáid style_reference_images ná style agus an liosta seo á úsáid.
styleroghnach
Cineálenum
RéamhshocrúAUTO
AUTOREALISTICFICTION
Cineál stíle a úsáidtear don ghiniúint; níl sé comhoiriúnach le style_codes.
expand_promptroghnach
Cineálboolean
Réamhshocrútrue
Scorán úsáide MagicPrompt le haghaidh giniúint iarratais.
num_imagesroghnach num_outputs
Cineálinteger
Réamhshocrú1
1 – 8
Líon na n-íomhánna le táirgeadh.
seedroghnach
Cineálinteger | null
Luach síl le haghaidh giniúint uimhreacha randamacha.
promptriachtanach
Cineálstring
Leid ina ndéantar cur síos ar an líonadh do réigiún mhasctha na híomhá.
image_sizeroghnach
Cineálobject
Réamhshocrúsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Taifeach atá le húsáid don íomhá aschuir.
negative_promptroghnach
Cineálstring
Réamhshocrú
Sonraigh ábhar íomhá nach dteastaíonn, agus tosaíocht ag tuairiscí na príomhleide ar na tuairiscí diúltacha seo.
reference_image_urlsriachtanach
Cineálurl[] · image
Íomhánna tagartha carachtair i bhformáid JPEG, PNG nó WebP, le teorainn chomhcheangailte 10 MB ar gach tagairt charachtair. Tá an tacaíocht teoranta faoi láthair d’íomhá amháin; déantar neamhaird d’íomhánna breise.
reference_mask_urlsroghnach
Cineálurl[] · image
Maisc tagartha carachtair i bhformáid JPEG, PNG nó WebP; ní ceadmhach don mhéid iomlán thar gach tagairt charachtair dul thar 10 MB. Ní úsáidtear ach 1 masc faoi láthair; déantar neamhaird d’aon mhaisc bhreise.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
images
array of object {url, content_type, file_name, file_size}
seed
integerLuach síl a úsáidtear le haghaidh giniúint uimhreacha randamacha.

Tuilleadh samhlacha: Eagarthóireacht Íomhá

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/ideogram/character.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt