Lumaktaw sa nilalaman

Ideogram Text to Image

I-integrate

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

Kahilingang ito: $0.06 60 kredito ng API · ≈ ₽6.33 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
rendering_speed default na BALANCED

Setting ng bilis para sa rendering.

image_size default na square_hd

Resolution na gagamitin para sa output na larawan.

num_images default na 1

Bilang ng larawang bubuuin.

advanced negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
default na

Tukuyin ang hindi gustong content ng larawan; mas nangingibabaw ang mga paglalarawan sa pangunahing prompt kaysa sa mga paglalarawan sa negative prompt.

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

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 Text to Image

Gumagawa ng mga larawan mula sa isang `prompt` na may rendering speeds TURBO, BALANCED o QUALITY. Gabayan ang hitsura gamit ang mga estilo reference na larawan (`image_urls`), `style_codes`, `color_palette`, `style` o isa sa 62 `style_preset` value. Sinusuportahan ang hanggang 8 larawan bawat call, negative prompt, opsyonal na pagpapalawak ng prompt at size preset.

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.
expand_promptopsyonal
Uriboolean
defaulttrue
Toggle ng paggamit ng MagicPrompt para sa pagbuo ng kahilingan.
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.
promptkinakailangan
Uristring
image_sizeopsyonal
Uriobject
defaultsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolution na gagamitin para sa output na larawan.
negative_promptopsyonal
Uristring
default
Tukuyin ang hindi gustong content ng larawan; mas nangingibabaw ang mga paglalarawan sa pangunahing prompt kaysa sa mga paglalarawan sa negative prompt.
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",
  "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"
  }
}
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: Text patungong Larawan

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