דילוג לתוכן

Ideogram V3 Edit

שילוב

מזהה מודל ideogram/v3/edit
# 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/edit?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה

הנחיה המתארת את המילוי עבור האזור המוסווה של התמונה.

•חובה image_url
גרור קובץ, או

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

•חובה mask_url
גרור קובץ, או

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

rendering_speed ברירת מחדל BALANCED

הגדרת המהירות לרינדור.

num_images ברירת מחדל 1

מספר התמונות להפקה.

מתקדם images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
גרור קובץ, או

תמונות ייחוס לסגנון בפורמט JPEG, PNG או WebP. הגודל המשולב שלהן לא יעלה על 10 MB.

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

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

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

לוח הצבעים המשמש במהלך היצירה. ציין קביעה מראש באמצעות name או צבעים הקסדצימליים מפורשים באמצעות members, עם אפשרות לכלול משקלים.

POST /run/ideogram/v3/edit?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/edit?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 V3 Edit

ממלא אזור ממוסך בתמונה בהתאם ל-`prompt`. לתמונה (`image_url`) ולמסכה (`mask_url`) חייבות להיות מידות זהות. ניתן לכוון את הסגנון באמצעות תמונות ייחוס, `style_codes`, ‏`color_palette` או `style_preset`. מהירות הרינדור היא TURBO, BALANCED או QUALITY, וניתן להחזיר 1 עד 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 בעת שימוש ברשימה זו.
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_urlחובה image
סוגurl · image
מקור היצירה המסופק ככתובת URL של תמונה, כאשר גם הרוחב וגם הגובה חייבים להיות זהים לחלוטין למידות המתאימות של המסכה.
mask_urlחובה mask
סוגurl · image
מסכת Inpainting המסופקת באמצעות URL, כאשר גם הרוחב וגם הגובה חייבים להיות זהים לחלוטין למידות המתאימות של תמונת הקלט.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/edit",
  "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",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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/edit.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt