דילוג לתוכן

Nucleus Image

שילוב

מזהה מודל nucleus-image
# 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/nucleus-image?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.01 ‏$⁩ 10 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Open model טקסט לתמונה #stylized#transform#typography

מודל טקסט-לתמונה עם ארכיטקטורת diffusion דלילה של מומחים מעורבים ו-7 הגדרות יחס תצוגה

Open model · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

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

•חובה

הנחיה שמכוונת את יצירת התמונה.

aspect_ratio ברירת מחדל 1:1

יחס הגובה-רוחב של התמונה שנוצרה, שנבחר מתוך אוסף קבוע של הגדרות קבועות ב-Nucleus-Image.

num_images ברירת מחדל 1

מספר התמונות המבוקש ליצירה.

מתקדם negative_prompt · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker
ברירת מחדל

הנחיה שלילית המוחלת במהלך היצירה.

output_format ברירת מחדל png

פורמט הקובץ של התמונה שהתקבלה.

ברירת מחדל 50

מספר שלבי ההסקה לביצוע.

ברירת מחדל 8

הקנה מידה המוחל על הנחיה ללא מסווג.

ערך Seed שהופך את היצירה לניתנת לשחזור.

POST /run/nucleus-image?wait=20 הצעת מחיר → ⁨‏0.01 ‏$⁩
# 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/nucleus-image?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 ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Nucleus Image

מייצר תמונות מ-`prompt` טקסטואלי, עם `negative_prompt` אופציונלי. יחס התצוגה נבחר מתוך שבע הגדרות: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ו-2:3. ניתן לשלוט ב-`num_inference_steps` (1 עד 100), ב-`guidance_scale` (0 עד 20) וב-`seed`, ולבקש עד 2 תמונות בפורמט png או jpeg.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
הנחיה שמכוונת את יצירת התמונה.
negative_promptאופציונלי
סוגstring
ברירת מחדל
הנחיה שלילית המוחלת במהלך היצירה.
aspect_ratioאופציונלי
סוגenum
ברירת מחדל1:1
1:116:99:164:33:43:22:3
יחס הגובה-רוחב של התמונה שנוצרה, שנבחר מתוך אוסף קבוע של הגדרות קבועות ב-Nucleus-Image.
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל50
1 – 100
מספר שלבי ההסקה לביצוע.
guidance_scaleאופציונלי
סוגnumber
ברירת מחדל8
0 – 20
הקנה מידה המוחל על הנחיה ללא מסווג.
seedאופציונלי
סוגinteger | null
ערך Seed שהופך את היצירה לניתנת לשחזור.
num_imagesאופציונלי num_outputs
סוגinteger
ברירת מחדל1
1 – 2
מספר התמונות המבוקש ליצירה.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
בדיקת בטיחות, שמחזירה תמונות שחורות במקום תמונות שסומנו כלא בטוחות. ערך true מאפשר את הבדיקה; false משבית אותה רק עבור חשבונות מורשים, בעוד שבקשות ללא הרשאה נבדקות בכל מקרה.
output_formatאופציונלי
סוגenum
ברירת מחדלpng
jpegpng
פורמט הקובץ של התמונה שהתקבלה.
חובה שם קנוני, מתקבל גם הוא

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "nucleus-image",
  "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": 10,
    "usd": "0.01",
    "charged": 10,
    "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",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
images
array of object {url, width, height, content_type}פרטי קובץ עבור התמונות שנוצרו.
timings
object
seed
integerSeed ליצירת תמונה, כולל הערך שנבחר באקראי אם הקלט לא כלל Seed; אחרת, הוא חוזר על הערך שסופק.
has_nsfw_concepts
array of booleanמציין אם מושגים מסוג NSFW מופיעים בתמונות שנוצרו.
prompt
stringהנחיה המשמשת במהלך יצירת התמונה.

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