Gå til indhold

Ideogram V3 Character

Integrer

Model-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"

Denne anmodning: 0,15 $ 150 API-kreditter Kør den på denne side

Hent API-nøgle
Ideogram Billedredigering Referenceinputs #character-consistency

Ideogram V3-generering, der holder en karakter konsistent ved hjælp af et referencebillede

Ideogram · Billede

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

•påkrævet

Prompt, der beskriver udfyldningen af billedets maskerede område.

•påkrævet
Slip en fil, eller

Karakterreferencebilleder i JPEG-, PNG- eller WebP-format med en samlet grænse på 10 MB for alle karakterreferencer. Understøttelsen er i øjeblikket begrænset til 1 billede; yderligere billeder ignoreres.

rendering_speed standard BALANCED

Hastighedsindstilling for rendering.

image_size standard square_hd

Opløsning, der skal bruges til outputbilledet.

num_images standard 1

Antal billeder, der skal produceres.

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

Angiv uønsket billedindhold, idet hovedpromptens beskrivelser har prioritet over disse negative promptbeskrivelser.

image_urls
Slip en fil, eller

Stilreferencebilleder i JPEG-, PNG- eller WebP-format. Deres samlede størrelse må ikke overstige 10 MB.

Slip en fil, eller

Masker til karakterreferencer i JPEG-, PNG- eller WebP-format; den samlede størrelse for alle karakterreferencer må ikke overstige 10 MB. Der bruges i øjeblikket kun 1 maske; yderligere masker ignoreres.

style standard AUTO

Stiltype, der bruges til generering; kan ikke bruges sammen med style_codes.

Seed-værdi til generering af tilfældige tal.

Billedstil-koder angivet som hexadecimale strenge på hver 8 tegn; udelad både style_reference_images og style, når denne liste bruges.

Farvepalette, der bruges under generering. Angiv enten en forudindstilling via name eller eksplicitte hexadecimalfarver via members, eventuelt med vægte.

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.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"

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Ideogram V3 Character

Genererer billeder af en karakter fra en `prompt` samt en reference i `reference_image_urls` (kun 1 billede bruges). Valgfrie stilreferencer angives i `image_urls`, med `style_codes`, `color_palette` og `reference_mask_urls` for mere kontrol. `rendering_speed` er TURBO, BALANCED eller QUALITY, og `num_images` går op til 8.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
image_urlsvalgfri images
Typeurl[] · image
Stilreferencebilleder i JPEG-, PNG- eller WebP-format. Deres samlede størrelse må ikke overstige 10 MB.
rendering_speedvalgfri
Typeenum
StandardBALANCED
TURBOBALANCEDQUALITY
Hastighedsindstilling for rendering.
color_palettevalgfri
Typeobject
Farvepalette, der bruges under generering. Angiv enten en forudindstilling via name eller eksplicitte hexadecimalfarver via members, eventuelt med vægte.
color_palette.membersvalgfri
Typeobject[]
Liste over palettemedlemmer, der definerer palettens farver.
color_palette.members[].rgbpåkrævet
Typeobject
Palettemedlemmets farve angivet som RGB.
color_palette.members[].color_weightvalgfri
Typenumber | null
Standard0.5
0,05 – 1
Vægt tildelt denne farve i paletten.
color_palette.namevalgfri
Typeenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Valg af forudindstilling for farvepaletten.
style_codesvalgfri
Typestring[]
Billedstil-koder angivet som hexadecimale strenge på hver 8 tegn; udelad både style_reference_images og style, når denne liste bruges.
stylevalgfri
Typeenum
StandardAUTO
AUTOREALISTICFICTION
Stiltype, der bruges til generering; kan ikke bruges sammen med style_codes.
expand_promptvalgfri
Typeboolean
Standardtrue
Skift til brug af MagicPrompt ved generering af anmodningen.
num_imagesvalgfri num_outputs
Typeinteger
Standard1
1 – 8
Antal billeder, der skal produceres.
seedvalgfri
Typeinteger | null
Seed-værdi til generering af tilfældige tal.
promptpåkrævet
Typestring
Prompt, der beskriver udfyldningen af billedets maskerede område.
image_sizevalgfri
Typeobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Opløsning, der skal bruges til outputbilledet.
negative_promptvalgfri
Typestring
Standard
Angiv uønsket billedindhold, idet hovedpromptens beskrivelser har prioritet over disse negative promptbeskrivelser.
reference_image_urlspåkrævet
Typeurl[] · image
Karakterreferencebilleder i JPEG-, PNG- eller WebP-format med en samlet grænse på 10 MB for alle karakterreferencer. Understøttelsen er i øjeblikket begrænset til 1 billede; yderligere billeder ignoreres.
reference_mask_urlsvalgfri
Typeurl[] · image
Masker til karakterreferencer i JPEG-, PNG- eller WebP-format; den samlede størrelse for alle karakterreferencer må ikke overstige 10 MB. Der bruges i øjeblikket kun 1 maske; yderligere masker ignoreres.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
images
array of object {url, content_type, file_name, file_size}
seed
integerSeed-værdi, der bruges til generering af tilfældige tal.

Flere modeller: Billedredigering

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/ideogram/character.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt