Gå til innhold

Ideogram V3 Character

Integrer

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"

Denne forespørselen: 0,15 $ 150 API-kreditter · ≈ 15,82 ₽ Kjør den på denne siden

Hent API-nøkkel
Ideogram Bilderedigering Referanseinndata #character-consistency

Ideogram V3-generering som holder en figur konsistent ved hjelp av et referansebilde

Ideogram · Bilde

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

•obligatorisk

Prompt som beskriver utfyllingen for bildets maskerte område.

•obligatorisk
Slipp en fil, eller

Referansebilder for karakterer i JPEG-, PNG- eller WebP-format, med en samlet grense på 10 MB for alle karakterreferanser. Støtte er for tiden begrenset til 1 bilde; flere bilder ignoreres.

rendering_speed standard BALANCED

Hastighetsinnstilling for gjengivelse.

image_size standard square_hd

Oppløsning som skal brukes for utdata-bildet.

num_images standard 1

Antall bilder som skal produseres.

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

Angi uønsket bildeinnhold; beskrivelsene i hovedprompten har prioritet over disse beskrivelsene i den negative prompten.

image_urls
Slipp en fil, eller

Stilreferansebilder i JPEG-, PNG- eller WebP-format. Den samlede størrelsen kan ikke overstige 10 MB.

Slipp en fil, eller

Masker for karakterreferanser i JPEG-, PNG- eller WebP-format; den totale størrelsen for alle karakterreferanser kan ikke overstige 10 MB. Bare 1 maske brukes for øyeblikket; flere masker ignoreres.

style standard AUTO

Stiltype brukt til generering; kan ikke brukes sammen med style_codes.

Seed-verdi for generering av tilfeldige tall.

Bilde-stilkoder, oppgitt som heksadesimale strenger på 8 tegn hver; utelat både style_reference_images og style når denne listen brukes.

Fargepalett brukt under generering. Angi enten en forhåndsinnstilling med name eller eksplisitte heksadesimale farger gjennom members, eventuelt med vekter.

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"

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om Ideogram V3 Character

Genererer bilder av en figur fra en `prompt` samt en referanse i `reference_image_urls` (bare 1 bilde brukes). Valgfrie stilreferanser legges i `image_urls`, med `style_codes`, `color_palette` og `reference_mask_urls` for mer kontroll. `rendering_speed` er TURBO, BALANCED eller QUALITY, og `num_images` går opp til 8.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
image_urlsvalgfritt images
Typeurl[] · image
Stilreferansebilder i JPEG-, PNG- eller WebP-format. Den samlede størrelsen kan ikke overstige 10 MB.
rendering_speedvalgfritt
Typeenum
StandardBALANCED
TURBOBALANCEDQUALITY
Hastighetsinnstilling for gjengivelse.
color_palettevalgfritt
Typeobject
Fargepalett brukt under generering. Angi enten en forhåndsinnstilling med name eller eksplisitte heksadesimale farger gjennom members, eventuelt med vekter.
color_palette.membersvalgfritt
Typeobject[]
Liste over palettmedlemmer som definerer palettens farger.
color_palette.members[].rgbobligatorisk
Typeobject
Palettmedlemmets farge uttrykt som RGB.
color_palette.members[].color_weightvalgfritt
Typenumber | null
Standard0.5
0,05 – 1
Vekt tilordnet denne fargen i paletten.
color_palette.namevalgfritt
Typeenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Valg av forhåndsinnstilling for fargepaletten.
style_codesvalgfritt
Typestring[]
Bilde-stilkoder, oppgitt som heksadesimale strenger på 8 tegn hver; utelat både style_reference_images og style når denne listen brukes.
stylevalgfritt
Typeenum
StandardAUTO
AUTOREALISTICFICTION
Stiltype brukt til generering; kan ikke brukes sammen med style_codes.
expand_promptvalgfritt
Typeboolean
Standardtrue
Bryter for bruk av MagicPrompt ved generering av forespørselen.
num_imagesvalgfritt num_outputs
Typeinteger
Standard1
1 – 8
Antall bilder som skal produseres.
seedvalgfritt
Typeinteger | null
Seed-verdi for generering av tilfeldige tall.
promptobligatorisk
Typestring
Prompt som beskriver utfyllingen for bildets maskerte område.
image_sizevalgfritt
Typeobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Oppløsning som skal brukes for utdata-bildet.
negative_promptvalgfritt
Typestring
Standard
Angi uønsket bildeinnhold; beskrivelsene i hovedprompten har prioritet over disse beskrivelsene i den negative prompten.
reference_image_urlsobligatorisk
Typeurl[] · image
Referansebilder for karakterer i JPEG-, PNG- eller WebP-format, med en samlet grense på 10 MB for alle karakterreferanser. Støtte er for tiden begrenset til 1 bilde; flere bilder ignoreres.
reference_mask_urlsvalgfritt
Typeurl[] · image
Masker for karakterreferanser i JPEG-, PNG- eller WebP-format; den totale størrelsen for alle karakterreferanser kan ikke overstige 10 MB. Bare 1 maske brukes for øyeblikket; flere masker ignoreres.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
images
array of object {url, content_type, file_name, file_size}
seed
integerSeed-verdi brukt til generering av tilfeldige tall.

Flere modeller: Bilderedigering

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/ideogram/character.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt