דילוג לתוכן

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

בקשה זו: ⁨‏0.06 ‏$⁩ 60 קרדיטי API · ≈ ⁨‏6.33 ‏₽⁩ הרצה בדף הזה

קבלת מפתח API
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.

קביעה מוגדרת מראש של סגנון, שבחירתה מכוונת את יצירת התמונה.

ערך סיד ליצירת מספרים אקראיים.

קודי סגנון תמונה, המסופקים כמחרוזות הקסדצימליות בנות 8 תווים כל אחת; השמט הן את style_reference_images והן את style בעת שימוש ברשימה זו.

לוח הצבעים המשמש במהלך היצירה. ציין קביעה מראש באמצעות name או צבעים הקסדצימליים מפורשים באמצעות 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.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"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Ideogram Text to Image

יוצר תמונות מ-`prompt` במהירויות רינדור TURBO, BALANCED או QUALITY. ניתן לכוון את המראה באמצעות תמונות ייחוס לסגנון (`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
לוח הצבעים המשמש במהלך היצירה. ציין קביעה מראש באמצעות name או צבעים הקסדצימליים מפורשים באמצעות 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
בחירת קביעה מראש עבור לוח הצבעים.
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
ערך סיד ליצירת מספרים אקראיים.
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
ברירת מחדל
ציין תוכן תמונה לא רצוי, כאשר לתיאורי ההנחיה הראשית יש עדיפות על פני תיאורי ההנחיה השלילית.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
images
array of object {url, content_type, file_name, file_size}
seed
integerערך סיד המשמש ליצירת מספרים אקראיים.

מודלים נוספים: טקסט לתמונה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/ideogram/v3.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt