Sleppa yfir í efni

Ideogram V3 Character

Tengja

Auðkenni líkans 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"

Þessi beiðni: 0,15 $ 150 API-inneignir Keyra á þessari síðu

Fá API-lykil
Ideogram Myndvinnsla Tilvísunarinnlegg #character-consistency

Ideogram V3-myndgerð sem heldur persónu samræmdri með viðmiðunarmynd

Ideogram · Mynd

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

•áskilið

Kvaðning sem lýsir fyllingu fyrir maskað svæði myndarinnar.

•áskilið
Slepptu skrá eða

Tilvísunarmyndir persóna á JPEG-, PNG- eða WebP-sniði, með samanlögðum hámarki 10 MB fyrir allar persónutilvísanir. Stuðningur er nú takmarkaður við 1 mynd; viðbótarmyndir eru hunsaðar.

rendering_speed sjálfgefið BALANCED

Hraðastilling fyrir myndgerð.

image_size sjálfgefið square_hd

Upplausn sem nota á fyrir úttaksmyndina.

num_images sjálfgefið 1

Fjöldi mynda sem á að búa til.

Ítarlegt negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
sjálfgefið

Tilgreindu óæskilegt myndefni; lýsingar aðalkvaðningarinnar hafa forgang fram yfir þessar lýsingar neikvæðu kvaðningarinnar.

image_urls
Slepptu skrá eða

Stíltilvísunarmyndir á JPEG-, PNG- eða WebP-sniði. Samanlögð stærð þeirra má ekki fara yfir 10 MB.

Slepptu skrá eða

Persónutilvísunarmaskar á JPEG-, PNG- eða WebP-sniði; heildarstærð allra persónutilvísana má ekki fara yfir 10 MB. Aðeins 1 maski er nú notaður og viðbótarmaskar hunsaðir.

style sjálfgefið AUTO

Stílgerð notuð við efnisgerð; útilokar notkun style_codes.

Fræ fyrir myndun slembitalna.

Kóðar fyrir myndstíl, gefnir sem hexadecimal-strengir með 8 stöfum hver; slepptu bæði style_reference_images og style þegar þessi listi er notaður.

Litaspjald notað við efnisgerð. Tilgreindu annaðhvort forstillingu með name eða skýr hexadecimal-liti með members, mögulega ásamt vægi.

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

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Ideogram V3 Character

Myndar myndir af persónu út frá `prompt` og viðmiðun í `reference_image_urls` (aðeins 1 mynd er notuð). Valfrjálsar stílviðmiðanir fara í `image_urls`, með `style_codes`, `color_palette` og `reference_mask_urls` fyrir meiri stjórn. `rendering_speed` er TURBO, BALANCED eða QUALITY og `num_images` getur verið allt að 8.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
image_urlsvalfrjálst images
Gerðurl[] · image
Stíltilvísunarmyndir á JPEG-, PNG- eða WebP-sniði. Samanlögð stærð þeirra má ekki fara yfir 10 MB.
rendering_speedvalfrjálst
Gerðenum
SjálfgefiðBALANCED
TURBOBALANCEDQUALITY
Hraðastilling fyrir myndgerð.
color_palettevalfrjálst
Gerðobject
Litaspjald notað við efnisgerð. Tilgreindu annaðhvort forstillingu með name eða skýr hexadecimal-liti með members, mögulega ásamt vægi.
color_palette.membersvalfrjálst
Gerðobject[]
Listi yfir litaspjaldsfærslur sem skilgreinir liti spjaldsins.
color_palette.members[].rgbáskilið
Gerðobject
Litur litaspjaldsfærslu, gefinn sem RGB.
color_palette.members[].color_weightvalfrjálst
Gerðnumber | null
Sjálfgefið0.5
0,05 – 1
Vægi þessa litar innan litaspjaldsins.
color_palette.namevalfrjálst
Gerðenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Val á forstillingu fyrir litaspjaldið.
style_codesvalfrjálst
Gerðstring[]
Kóðar fyrir myndstíl, gefnir sem hexadecimal-strengir með 8 stöfum hver; slepptu bæði style_reference_images og style þegar þessi listi er notaður.
stylevalfrjálst
Gerðenum
SjálfgefiðAUTO
AUTOREALISTICFICTION
Stílgerð notuð við efnisgerð; útilokar notkun style_codes.
expand_promptvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Kveikja á notkun MagicPrompt við gerð beiðni.
num_imagesvalfrjálst num_outputs
Gerðinteger
Sjálfgefið1
1 – 8
Fjöldi mynda sem á að búa til.
seedvalfrjálst
Gerðinteger | null
Fræ fyrir myndun slembitalna.
promptáskilið
Gerðstring
Kvaðning sem lýsir fyllingu fyrir maskað svæði myndarinnar.
image_sizevalfrjálst
Gerðobject
Sjálfgefiðsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Upplausn sem nota á fyrir úttaksmyndina.
negative_promptvalfrjálst
Gerðstring
Sjálfgefið
Tilgreindu óæskilegt myndefni; lýsingar aðalkvaðningarinnar hafa forgang fram yfir þessar lýsingar neikvæðu kvaðningarinnar.
reference_image_urlsáskilið
Gerðurl[] · image
Tilvísunarmyndir persóna á JPEG-, PNG- eða WebP-sniði, með samanlögðum hámarki 10 MB fyrir allar persónutilvísanir. Stuðningur er nú takmarkaður við 1 mynd; viðbótarmyndir eru hunsaðar.
reference_mask_urlsvalfrjálst
Gerðurl[] · image
Persónutilvísunarmaskar á JPEG-, PNG- eða WebP-sniði; heildarstærð allra persónutilvísana má ekki fara yfir 10 MB. Aðeins 1 maski er nú notaður og viðbótarmaskar hunsaðir.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
images
array of object {url, content_type, file_name, file_size}
seed
integerFræ notað við myndun slembitalna.

Fleiri líkön: Myndvinnsla

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/ideogram/character.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt