Leum chun t-susbaint

Ideogram Text to Image

Amalaich

ID a’ mhodail ideogram/v3
# 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/v3?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"
  }'

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

An t-iarrtas seo: $0.06 60 creideasan API · ≈ ₽6.33 Ruith e air an duilleig seo

Faigh iuchair API
Ideogram · Ìomhaigh

Thèid a’ chiad toradh agad an-seo

Tog iarrtas gu h-ìosal agus ruith e leis an iuchair API agad. Tha na h-às-churan air an lethbhreacadh dhan stòradh againn, air an cumail gu bràth no 7 latha an-asgaidh.

Tog iarrtas

Tha na smachdan air an cruthachadh bho sgeama a’ mhodail. Bidh an còd agus a’ phrìs ag ùrachadh fhad ’s a dh’atharraicheas tu iad.

•riatanach
rendering_speed bun-roghainn BALANCED

Suidheachadh astair airson renderadh.

image_size bun-roghainn square_hd

Dùmhlachd-bhreacaidh a thèid a chleachdadh airson na h-ìomhaigh às-chuir.

num_images bun-roghainn 1

Àireamh nan ìomhaighean ri chruthachadh.

Adhartach negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
bun-roghainn

Sònraich susbaint ìomhaigh nach eilear ag iarraidh; tha tuairisgeulan a’ phrìomh phrompt a’ faighinn prìomhachas thairis air na tuairisgeulan sa phrompt àicheil seo.

image_urls
Leig às faidhle, no

Ìomhaighean iomraidh stoidhle ann am fòrmat JPEG, PNG no WebP. Chan fhaod am meud còmhla a bhith nas motha na 10 MB.

style

Seòrsa stoidhle a thèid a chleachdadh airson gineadh; chan urrainnear a chleachdadh còmhla ri style_codes.

Ro-shuidheachadh stoidhle a bhios a’ stiùireadh gineadh na h-ìomhaigh nuair a thèid a thaghadh.

Luach sìl airson gineadh àireamhan air thuaiream.

Còdan stoidhle ìomhaigh, air an toirt seachad mar theudan hexadecimal de 8 caractaran gach fear; fàg às an dà chuid style_reference_images agus style nuair a bhios tu a’ cleachdadh na liosta seo.

Pailead dhathan a thèid a chleachdadh rè a’ ghineadh. Sònraich ro-shuidheachadh tro ainm no dathan hexadecimal soilleir tro members, le cuideaman roghainneil.

POST /run/ideogram/v3?wait=20 tuairmse → $0.06
# 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/v3?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"
  }'

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

Ruith an t-iarrtas seo

Fuirichidh an iuchair agad sa bhrobhsair seo: thèid a cur chun Doitong API a-mhàin agus a sàbhaladh (localStorage) a-mhàin ma chuireas tu comharra ri Cuimhnich. Faigh iuchair API

Mu Ideogram Text to Image

Gineadh e ìomhaighean bho `prompt` le astaran tairgse TURBO, BALANCED no QUALITY. Stiùir an coltas tro ìomhaighean iomraidh stoidhle (`image_urls`), `style_codes`, `color_palette`, `style` no aon de 62 luachan `style_preset`. A’ toirt taic do suas ri 8 ìomhaighean gach gairm, prompt àicheil, leudachadh prompt roghainneil agus ro-shuidhichidhean meud.

Paramadairean

Cuir an t-ainm canonical no an t-ainm dùthchasach, chan e an dà chuid. Ainmean canonical

AinmSeòrsa Bun-roghainnCeadaichte Tuairisgeul
image_urlsroghainneil images
Seòrsaurl[] · image
Ìomhaighean iomraidh stoidhle ann am fòrmat JPEG, PNG no WebP. Chan fhaod am meud còmhla a bhith nas motha na 10 MB.
rendering_speedroghainneil
Seòrsaenum
Bun-roghainnBALANCED
TURBOBALANCEDQUALITY
Suidheachadh astair airson renderadh.
color_paletteroghainneil
Seòrsaobject
Pailead dhathan a thèid a chleachdadh rè a’ ghineadh. Sònraich ro-shuidheachadh tro ainm no dathan hexadecimal soilleir tro members, le cuideaman roghainneil.
color_palette.membersroghainneil
Seòrsaobject[]
Liosta bhall na paileid a’ mìneachadh dathan na paileid.
color_palette.members[].rgbriatanach
Seòrsaobject
Dath ball na paileid air a chur an cèill mar RGB.
color_palette.members[].color_weightroghainneil
Seòrsanumber | null
Bun-roghainn0.5
0.05 – 1
Cuideam a chaidh a shònrachadh don dath seo taobh a-staigh na paileid.
color_palette.nameroghainneil
Seòrsaenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Taghadh ro-shuidhichte airson na paileid dhathan.
style_codesroghainneil
Seòrsastring[]
Còdan stoidhle ìomhaigh, air an toirt seachad mar theudan hexadecimal de 8 caractaran gach fear; fàg às an dà chuid style_reference_images agus style nuair a bhios tu a’ cleachdadh na liosta seo.
styleroghainneil
Seòrsaenum
AUTOGENERALREALISTICDESIGN
Seòrsa stoidhle a thèid a chleachdadh airson gineadh; chan urrainnear a chleachdadh còmhla ri style_codes.
expand_promptroghainneil
Seòrsaboolean
Bun-roghainntrue
Togail/suidheachadh cleachdaidh MagicPrompt airson gineadh iarrtais.
num_imagesroghainneil num_outputs
Seòrsainteger
Bun-roghainn1
1 – 8
Àireamh nan ìomhaighean ri chruthachadh.
seedroghainneil
Seòrsainteger | null
Luach sìl airson gineadh àireamhan air thuaiream.
style_presetroghainneil
Seòrsaenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 eileCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
Ro-shuidheachadh stoidhle a bhios a’ stiùireadh gineadh na h-ìomhaigh nuair a thèid a thaghadh.
promptriatanach
Seòrsastring
image_sizeroghainneil
Seòrsaobject
Bun-roghainnsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dùmhlachd-bhreacaidh a thèid a chleachdadh airson na h-ìomhaigh às-chuir.
negative_promptroghainneil
Seòrsastring
Bun-roghainn
Sònraich susbaint ìomhaigh nach eilear ag iarraidh; tha tuairisgeulan a’ phrìomh phrompt a’ faighinn prìomhachas thairis air na tuairisgeulan sa phrompt àicheil seo.
riatanach Ainm canonical, gabhar ris cuideachd

Gabhaidh paramadairean faidhle ri URL poblach https://, URI data: suas ri 10 MB, no file_url de luchdachadh suas. Faidhlichean

Toradh

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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"
  }
}
Na faidhlichean agad, do roghainnTha gach outputs[].url na lethbhreac air an stòradh againn: air a chumail gu bràth (air a phàigheadh gach GB-mìos) no 7 latha an-asgaidh, a rèir suidheachadh a’ chunntais agad no ?storage=.
An aon chruth air gach modailtype, url, content_type, width, height agus duration, airson dealbhan, bhidio agus fuaim le chèile. ’S e output nì toraidh a’ mhodail fhèin.
Raointean toraidh
images
array of object {url, content_type, file_name, file_size}
seed
integerLuach sìl a chaidh a chleachdadh airson gineadh àireamhan air thuaiream.

Barrachd mhodalan: Teacsa gu Ìomhaigh

Do riochdairean AI: tha an duilleag seo mar Markdown aig https://doitong.com/gd/developers/models/ideogram/v3.md. Na modailean agus na treòraichean uile: https://doitong.com/developers/llms.txt