Sleppa yfir í efni

Ideogram V3 Character Edit

Tengja

Auðkenni líkans 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

Grímubundin Ideogram V3-vinnsla á mynd sem varðveitir auðkenni viðmiðaðrar persónu

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ð image_url
Slepptu skrá eða

Uppspretta efnisgerðar gefin sem vefslóð myndar; bæði breidd og hæð verða að vera nákvæmlega þær sömu og samsvarandi mál maskans.

•áskilið mask_url
Slepptu skrá eða

Inpainting-mask gefin með vefslóð; bæði breidd og hæð verða að vera nákvæmlega þær sömu og samsvarandi mál inntaksmyndarinnar.

•á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ð.

num_images sjálfgefið 1

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

Ítarlegt images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette
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.

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/edit?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.ru/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.ru/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 Edit

Fyllir út grímusvæði í `image_url` með `mask_url` (bæði verða að hafa sömu stærðir), `prompt` og persónuviðmiðun í `reference_image_urls` (1 mynd notuð). Hentar til að breyta stellingu, svipbrigðum eða klæðnaði. Valfrjálsar stílviðmiðanir, `rendering_speed` og allt að 8 úttök.

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.
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_urláskilið image
Gerðurl · image
Uppspretta efnisgerðar gefin sem vefslóð myndar; bæði breidd og hæð verða að vera nákvæmlega þær sömu og samsvarandi mál maskans.
mask_urláskilið mask
Gerðurl · image
Inpainting-mask gefin með vefslóð; bæði breidd og hæð verða að vera nákvæmlega þær sömu og samsvarandi mál inntaksmyndarinnar.
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/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/edit.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt