Peke ki ngā ihirangi

Ideogram · v3 · Reframe

Whakauru

id tauira ideogram/v3/reframe
# 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/v3/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  }'

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

Tēnei tono: $ 0.06 60 whiwhinga API Whakahaerehia ki tēnei whārangi

Tikina he kī API
Ideogram · Atahanga

Kei konei tō hua tuatahi

Hangaia he tono ki raro nei, ka whakahaere mā tō kī API. Ka tāruatia ngā putanga ki tō mātou rokiroki, ka puritia mō ake tonu atu, mō rānei 7 rā mō te kore utu.

Hangaia he tono

Ka hangaia ngā mana whakahaere mai i te aronuinga o te tauira. Ka whakahoungia te waehere me te utu ina whakarerekē koe.

•e hiahiatia ana image_url
Whakataka he kōnae,

URL e tohu ana ki te atahanga e whakaritea anō ana.

rendering_speed taunoa BALANCED

Tautuhinga tere mō te tāhuahua.

image_size •e hiahiatia ana

Taumira o te atahanga i hangaia mā te whakarite anō.

num_images taunoa 1

Te maha o ngā atahanga hei whakaputa.

Arā atu images · style · style_preset · seed · style_codes · color_palette
image_urls
Whakataka he kōnae,

Ngā atahanga tohutoro kāhua ki te hōputu JPEG, PNG, WebP rānei. Kaua e neke ake i te 10 MB te rahi whakakotahi.

style

Momo kāhua e whakamahia ana mō te whakaputanga; kāore e taea te whakamahi tahi me style_codes.

Tautuhinga kāhua e ārahi ana i te whakaputanga atahanga.

Uara kākano mō te whakaputa tau matapōkere.

Ngā waehere kāhua atahanga, ka tukuna hei aho hexadecimal e 8 ngā pūāhua ia mea; kaua e whakamahi i style_reference_images me style ina whakamahi i tēnei rārangi.

Papatae tae e whakamahia ana i te whakaputanga. Tautuhia he tatūkē mā te ingoa, he tae hexadecimal rānei mā ngā mema, ā, ka taea te whakauru taumahatanga.

POST /run/ideogram/v3/reframe?wait=20 utu → $ 0.06
# 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/v3/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  }'

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

Whakahaerehia tēnei tono

Ka noho tō kī ki tēnei pūtirotiro: ka tukuna ki te Doitong API anake, ā, ka tiakina ki te localStorage anake ina tohua e koe te Mahara. Tikina he kī API

Mō Ideogram · v3 · Reframe

Ka tārai anō i tētahi whakaahua tīariari (`image_url`) ki te `image_size` ūnga e hiahiatia ana, pēnei i ngā tatūkē tapawhā, tū whakaahua, whenua rānei, me te whakaputa ihirangi hou hei whakakī i te wāhi tāpiri. Ka taea te ārahi i te kāhua mā ngā whakaahua tohutoro, `style_codes`, `color_palette`, `style`, `style_preset` rānei. Ka tautoko i ngā tere TURBO, BALANCED, QUALITY me te 1 ki te 8 putanga.

Ngā tawhā

Tukuna te ingoa tōmua, te ingoa taketake rānei, kaua e rua. Ngā ingoa tōmua

IngoaMomo TaunoaE whakaaetia ana Whakamārama
image_urlskōwhiringa images
Momourl[] · image
Ngā atahanga tohutoro kāhua ki te hōputu JPEG, PNG, WebP rānei. Kaua e neke ake i te 10 MB te rahi whakakotahi.
rendering_speedkōwhiringa
Momoenum
TaunoaBALANCED
TURBOBALANCEDQUALITY
Tautuhinga tere mō te tāhuahua.
color_palettekōwhiringa
Momoobject
Papatae tae e whakamahia ana i te whakaputanga. Tautuhia he tatūkē mā te ingoa, he tae hexadecimal rānei mā ngā mema, ā, ka taea te whakauru taumahatanga.
color_palette.memberskōwhiringa
Momoobject[]
Rārangi mema papatae e tautuhi ana i ngā tae o te papatae.
color_palette.members[].rgbe hiahiatia ana
Momoobject
Tae o te mema papatae kua whakaaturia hei RGB.
color_palette.members[].color_weightkōwhiringa
Momonumber | null
Taunoa0.5
0.05 – 1
Taumaha kua tautapaina ki tēnei tae i roto i te papatae.
color_palette.namekōwhiringa
Momoenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Kōwhiringa tatūkē mō te papatae tae.
style_codeskōwhiringa
Momostring[]
Ngā waehere kāhua atahanga, ka tukuna hei aho hexadecimal e 8 ngā pūāhua ia mea; kaua e whakamahi i style_reference_images me style ina whakamahi i tēnei rārangi.
stylekōwhiringa
Momoenum
AUTOGENERALREALISTICDESIGN
Momo kāhua e whakamahia ana mō te whakaputanga; kāore e taea te whakamahi tahi me style_codes.
num_imageskōwhiringa num_outputs
Momointeger
Taunoa1
1 – 8
Te maha o ngā atahanga hei whakaputa.
seedkōwhiringa
Momointeger | null
Uara kākano mō te whakaputa tau matapōkere.
style_presetkōwhiringa
Momoenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 anōCOLORING_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
Tautuhinga kāhua e ārahi ana i te whakaputanga atahanga.
image_urle hiahiatia ana image
Momourl · image
URL e tohu ana ki te atahanga e whakaritea anō ana.
image_sizee hiahiatia ana
Momoobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Taumira o te atahanga i hangaia mā te whakarite anō.
e hiahiatia ana Ingoa tōmua, e whakaaetia ana hoki

Mō ngā tawhā kōnae, whakamahia he URL tūmatanui https://, he URI data: tae atu ki te 10 MB, he file_url rānei o tētahi tukuake. Ngā kōnae

Putanga

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/reframe",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  },
  "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"
  }
}
Ō kōnae, māu e whiriwhiriKo ia url o outputs[] he tārua kei tō mātou rokiroki: ka puritia mō ake tonu atu (ka utua ia GB-marama) mō rānei 7 rā mō te kore utu, e ai ki ngā tautuhinga o tō pūkete, ki te ?storage= rānei.
He ōrite te hanga ki ia tauiratype, url, content_type, width, height me duration, mō ngā pikitia, ataata me te oro. Ko output te ahanoa hua ake o te tauira.
Ngā āpure o te putanga
images
array of object {url, content_type, file_name, file_size}
seed
integerUara kākano e whakamahia ana mō te whakaputa tau matapōkere.

Ētahi atu tauira: Whakatika Atahanga

Mō ngā āpiha AI: kei te wātea tēnei whārangi hei Markdown ki https://doitong.com/mi/developers/models/ideogram/v3/reframe.md. Ngā tauira me ngā aratohu katoa: https://doitong.com/developers/llms.txt