Lumaktaw sa nilalaman

Ideogram · v3 · Reframe

I-integrate

ID ng modelo 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"

Kahilingang ito: $0.06 60 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key
Ideogram · Larawan

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan image_url
Mag-drop ng file, o

URL na tumutukoy sa larawang ire-reframe.

rendering_speed default na BALANCED

Setting ng bilis para sa rendering.

image_size •kinakailangan

Resolution ng larawang ginawa sa pamamagitan ng reframing.

num_images default na 1

Bilang ng larawang bubuuin.

advanced images · style · style_preset · seed · style_codes · color_palette
image_urls
Mag-drop ng file, o

Mga style reference na larawan sa JPEG, PNG o WebP format. Hindi dapat lumampas sa 10 MB ang pinagsamang laki ng mga ito.

style

Uri ng style na ginagamit sa pagbuo; hindi maaaring gamitin kasabay ng style_codes.

Style preset na gumagabay sa pagbuo ng larawan batay sa napiling setting.

Seed value para sa pagbuo ng random number.

Mga image-style code na ibinibigay bilang hexadecimal string na may tig-8 character; huwag isama ang style_reference_images at style kapag ginagamit ang listahang ito.

Color palette na ginagamit habang nagbubuo. Tumukoy ng preset sa pamamagitan ng name o ng tahasang hexadecimal color sa pamamagitan ng members, na maaaring lagyan ng weights.

POST /run/ideogram/v3/reframe?wait=20 presyo → $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"

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Ideogram · v3 · Reframe

Binabago ang framing ng kasalukuyang larawan (`image_url`) ayon sa kinakailangang target na `image_size`, gaya ng square, portrait o landscape preset, at bumubuo ng bagong content para punan ang dagdag na espasyo. Maaaring gabayan ang estilo gamit ang mga reference na larawan, `style_codes`, `color_palette`, `style` o `style_preset`. Sinusuportahan ang TURBO, BALANCED o QUALITY speed at 1 hanggang 8 output.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
image_urlsopsyonal images
Uriurl[] · image
Mga style reference na larawan sa JPEG, PNG o WebP format. Hindi dapat lumampas sa 10 MB ang pinagsamang laki ng mga ito.
rendering_speedopsyonal
Urienum
defaultBALANCED
TURBOBALANCEDQUALITY
Setting ng bilis para sa rendering.
color_paletteopsyonal
Uriobject
Color palette na ginagamit habang nagbubuo. Tumukoy ng preset sa pamamagitan ng name o ng tahasang hexadecimal color sa pamamagitan ng members, na maaaring lagyan ng weights.
color_palette.membersopsyonal
Uriobject[]
Listahan ng palette member na tumutukoy sa mga kulay ng palette.
color_palette.members[].rgbkinakailangan
Uriobject
Kulay ng palette member na ipinahayag bilang RGB.
color_palette.members[].color_weightopsyonal
Urinumber | null
default0.5
0.05 – 1
Weight na itinalaga sa kulay na ito sa loob ng palette.
color_palette.nameopsyonal
Urienum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Pagpili ng preset para sa color palette.
style_codesopsyonal
Uristring[]
Mga image-style code na ibinibigay bilang hexadecimal string na may tig-8 character; huwag isama ang style_reference_images at style kapag ginagamit ang listahang ito.
styleopsyonal
Urienum
AUTOGENERALREALISTICDESIGN
Uri ng style na ginagamit sa pagbuo; hindi maaaring gamitin kasabay ng style_codes.
num_imagesopsyonal num_outputs
Uriinteger
default1
1 – 8
Bilang ng larawang bubuuin.
seedopsyonal
Uriinteger | null
Seed value para sa pagbuo ng random number.
style_presetopsyonal
Urienum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 paCOLORING_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
Style preset na gumagabay sa pagbuo ng larawan batay sa napiling setting.
image_urlkinakailangan image
Uriurl · image
URL na tumutukoy sa larawang ire-reframe.
image_sizekinakailangan
Uriobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolution ng larawang ginawa sa pamamagitan ng reframing.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

Output

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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
images
array of object {url, content_type, file_name, file_size}
seed
integerSeed value na ginagamit para sa pagbuo ng random number.

Higit pang modelo: Pag-edit ng Larawan

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/ideogram/v3/reframe.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt