Мазмұнға өту

Ideogram Text to Image

Интеграциялау

Модель идентификаторы ideogram/v3
# 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?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрау: 0,06 $ 60 API кредиті Осы бетте іске қосу

API кілтін алу
Ideogram Мәтіннен кескінге #realism#typography

Стиль референстері, түс палитралары, алдын ала орнатылған параметрлері бар және 8 дейінгі кескін жасайтын, мәтіннен кескінге арналған Ideogram V3

Ideogram · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті
rendering_speed әдепкі BALANCED

Рендерлеу жылдамдығының параметрі.

image_size әдепкі square_hd

Шығыс кескіні үшін пайдаланылатын ажыратымдылық.

num_images әдепкі 1

Жасалатын кескіндер саны.

Қосымша negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
әдепкі

Негізгі нұсқау сипаттамалары басым бола отырып, қажетсіз кескін мазмұнын көрсетіңіз.

image_urls
Файлды тастаңыз немесе

JPEG, PNG немесе WebP пішіміндегі стиль сілтемесі кескіндері. Олардың жалпы өлшемі 10 MB-тан аспауы керек.

style

Генерация үшін пайдаланылатын стиль түрі; style_codes параметрімен өзара үйлеспейді.

Таңдалуы кескін генерациясын бағыттайтын стиль пресеті.

Кездейсоқ сандар генерациясына арналған seed мәні.

Әрқайсысы 8 таңбалы он алтылық жол ретінде берілетін кескін стилінің кодтары; бұл тізімді пайдаланғанда style_reference_images және style параметрлерін көрсетпеңіз.

Генерация кезінде пайдаланылатын түстер палитрасы. Атау арқылы preset немесе members арқылы нақты он алтылық түстерді, қажет болса салмақтарымен бірге көрсетіңіз.

POST /run/ideogram/v3?wait=20 бағасы → 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?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Ideogram Text to Image туралы

TURBO, BALANCED немесе QUALITY көрсету жылдамдығымен `prompt` бойынша кескіндер жасайды. Көріністі стиль анықтамалық кескіндері (`image_urls`), `style_codes`, `color_palette`, `style` немесе 62 `style_preset` мәнінің бірі арқылы бағыттауға болады. Бір сұрауда 8 кескінге дейін, теріс нұсқау, қосымша нұсқау кеңейтуі және өлшем алдын ала баптаулары қолдау табады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlsміндетті емес images
Түріurl[] · image
JPEG, PNG немесе WebP пішіміндегі стиль сілтемесі кескіндері. Олардың жалпы өлшемі 10 MB-тан аспауы керек.
rendering_speedміндетті емес
Түріenum
ӘдепкіBALANCED
TURBOBALANCEDQUALITY
Рендерлеу жылдамдығының параметрі.
color_paletteміндетті емес
Түріobject
Генерация кезінде пайдаланылатын түстер палитрасы. Атау арқылы preset немесе members арқылы нақты он алтылық түстерді, қажет болса салмақтарымен бірге көрсетіңіз.
color_palette.membersміндетті емес
Түріobject[]
Палитра түстерін анықтайтын палитра мүшелерінің тізімі.
color_palette.members[].rgbміндетті
Түріobject
Палитра мүшесінің RGB түрінде көрсетілген түсі.
color_palette.members[].color_weightміндетті емес
Түріnumber | null
Әдепкі0.5
0,05 – 1
Палитрада осы түске тағайындалған салмақ.
color_palette.nameміндетті емес
Түріenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Түстер палитрасына арналған preset таңдау.
style_codesміндетті емес
Түріstring[]
Әрқайсысы 8 таңбалы он алтылық жол ретінде берілетін кескін стилінің кодтары; бұл тізімді пайдаланғанда style_reference_images және style параметрлерін көрсетпеңіз.
styleміндетті емес
Түріenum
AUTOGENERALREALISTICDESIGN
Генерация үшін пайдаланылатын стиль түрі; style_codes параметрімен өзара үйлеспейді.
expand_promptміндетті емес
Түріboolean
Әдепкіtrue
Сұрау генерациясына арналған MagicPrompt пайдалану ауыстырып-қосқышы.
num_imagesміндетті емес num_outputs
Түріinteger
Әдепкі1
1 – 8
Жасалатын кескіндер саны.
seedміндетті емес
Түріinteger | null
Кездейсоқ сандар генерациясына арналған seed мәні.
style_presetміндетті емес
Түріenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
тағы 46COLORING_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
Таңдалуы кескін генерациясын бағыттайтын стиль пресеті.
promptміндетті
Түріstring
image_sizeміндетті емес
Түріobject
Әдепкіsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Шығыс кескіні үшін пайдаланылатын ажыратымдылық.
negative_promptміндетті емес
Түріstring
Әдепкі
Негізгі нұсқау сипаттамалары басым бола отырып, қажетсіз кескін мазмұнын көрсетіңіз.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
images
array of object {url, content_type, file_name, file_size}
seed
integerКездейсоқ сандар генерациясына пайдаланылатын seed мәні.

Қосымша модельдер: Мәтіннен кескінге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/ideogram/v3.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt