Hoppa till innehåll

Ideogram V3 Character

Integrera

Modell-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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Den här begäran: 0,15 $ 150 API-krediter · ≈ 15,82 ₽ Kör den på den här sidan

Hämta API-nyckel
Ideogram Bildredigering Referensinmatningar #character-consistency

Ideogram V3-generering som bevarar en konsekvent karaktär med hjälp av en referensbild

Ideogram · Bild

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

•obligatoriskt

Prompt som beskriver ifyllnaden för bildens maskerade område.

•obligatoriskt
Släpp en fil eller

Karaktärsreferensbilder i JPEG-, PNG- eller WebP-format, med en sammanlagd gräns på 10 MB för alla karaktärsreferenser. Stöd är för närvarande begränsat till 1 bild; ytterligare bilder ignoreras.

rendering_speed standard BALANCED

Hastighetsinställning för rendering.

image_size standard square_hd

Upplösning som ska användas för utdata-bilden.

num_images standard 1

Antal bilder som ska produceras.

Avancerat negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
standard

Ange oönskat bildinnehåll; beskrivningarna i huvudprompten har företräde framför dessa beskrivningar i den negativa prompten.

image_urls
Släpp en fil eller

Stilreferensbilder i JPEG-, PNG- eller WebP-format. Den sammanlagda storleken får inte överstiga 10 MB.

Släpp en fil eller

Karaktärsreferensmasker i JPEG-, PNG- eller WebP-format; den totala storleken för alla karaktärsreferenser får inte överstiga 10 MB. Endast 1 mask används för närvarande; ytterligare masker ignoreras.

style standard AUTO

Stiltyp som används för genereringen; ömsesidigt uteslutande med style_codes.

Seed-värde för generering av slumptal.

Bildstilskoder, angivna som hexadecimala strängar med 8 tecken vardera; utelämna både style_reference_images och style när denna lista används.

Färgpalett som används under genereringen. Ange antingen en förinställning via name eller uttryckliga hexadecimala färger via members, eventuellt med vikter.

POST /run/ideogram/character?wait=20 pris → 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?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Ideogram V3 Character

Genererar bilder av en karaktär från en `prompt` samt en referens i `reference_image_urls` (endast 1 bild används). Valfria stilreferenser anges i `image_urls`, med `style_codes`, `color_palette` och `reference_mask_urls` för större kontroll. `rendering_speed` är TURBO, BALANCED eller QUALITY och `num_images` kan vara upp till 8.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
image_urlsvalfritt images
Typurl[] · image
Stilreferensbilder i JPEG-, PNG- eller WebP-format. Den sammanlagda storleken får inte överstiga 10 MB.
rendering_speedvalfritt
Typenum
StandardBALANCED
TURBOBALANCEDQUALITY
Hastighetsinställning för rendering.
color_palettevalfritt
Typobject
Färgpalett som används under genereringen. Ange antingen en förinställning via name eller uttryckliga hexadecimala färger via members, eventuellt med vikter.
color_palette.membersvalfritt
Typobject[]
Lista över palettmedlemmar som definierar palettens färger.
color_palette.members[].rgbobligatoriskt
Typobject
Palettmedlemmens färg uttryckt som RGB.
color_palette.members[].color_weightvalfritt
Typnumber | null
Standard0.5
0,05 – 1
Vikt som tilldelats denna färg i paletten.
color_palette.namevalfritt
Typenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Val av förinställning för färgpaletten.
style_codesvalfritt
Typstring[]
Bildstilskoder, angivna som hexadecimala strängar med 8 tecken vardera; utelämna både style_reference_images och style när denna lista används.
stylevalfritt
Typenum
StandardAUTO
AUTOREALISTICFICTION
Stiltyp som används för genereringen; ömsesidigt uteslutande med style_codes.
expand_promptvalfritt
Typboolean
Standardtrue
Växlare för MagicPrompt-användning vid generering av begäran.
num_imagesvalfritt num_outputs
Typinteger
Standard1
1 – 8
Antal bilder som ska produceras.
seedvalfritt
Typinteger | null
Seed-värde för generering av slumptal.
promptobligatoriskt
Typstring
Prompt som beskriver ifyllnaden för bildens maskerade område.
image_sizevalfritt
Typobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Upplösning som ska användas för utdata-bilden.
negative_promptvalfritt
Typstring
Standard
Ange oönskat bildinnehåll; beskrivningarna i huvudprompten har företräde framför dessa beskrivningar i den negativa prompten.
reference_image_urlsobligatoriskt
Typurl[] · image
Karaktärsreferensbilder i JPEG-, PNG- eller WebP-format, med en sammanlagd gräns på 10 MB för alla karaktärsreferenser. Stöd är för närvarande begränsat till 1 bild; ytterligare bilder ignoreras.
reference_mask_urlsvalfritt
Typurl[] · image
Karaktärsreferensmasker i JPEG-, PNG- eller WebP-format; den totala storleken för alla karaktärsreferenser får inte överstiga 10 MB. Endast 1 mask används för närvarande; ytterligare masker ignoreras.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
images
array of object {url, content_type, file_name, file_size}
seed
integerSeed-värde som används för generering av slumptal.

Fler modeller: Bildredigering

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/ideogram/character.md. Alla modeller och guider: https://doitong.com/developers/llms.txt