דילוג לתוכן

Trellis 2

שילוב

מזהה מודל trellis-2
# 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/trellis-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ⁨‏0.30 ‏$⁩ 300 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Microsoft תמונה ל-3D #image-to-3d

הופך תמונה יחידה לרשת 3D מסוג GLB עם טקסטורה, והגדרות ניתנות לכוונון למבנה, צורה, טקסטורה ו-UV

Microsoft · 3D

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

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

בנה בקשה

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

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

כתובת URL המפנה לתמונת המקור להמרה תלת־ממדית.

resolution ברירת מחדל 1024

רזולוציית הפלט; הגדלתה מוסיפה פרטים אך אורכת זמן רב יותר.

מתקדם texture_size · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh
texture_size ברירת מחדל 2048

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

ברירת מחדל 7.5

בקרת נאמנות של המבנה התלת־ממדי הראשוני: הגדלתה מעדיפה התאמה קרובה יותר לתמונת הקלט, במחיר של רעש נוסף אפשרי.

ברירת מחדל 0.7

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

ברירת מחדל 0.6

גבול ההתחלה של חלון ההנחיה ללא מסווג בשלב 1 (מבנה דליל), המבוטא כשבריר של הסרת הרעשים. הגדרות נמוכות יותר מתחילות את ההנחיה מוקדם יותר; רק המרווח מ-interval_start עד interval_end משתמש בהנחיה, ובשאר המקומות העיבוד אינו מונחה.

ברירת מחדל 1

סף ההנחיה לשלב 1 (מבנה דליל): יש לבחור ערך גדול או שווה ל-ss_guidance_interval_start. הערך מציין את שבר הסרת הרעשים שאליו מגיעים כאשר ההנחיה ללא מסווג נעצרת.

ברירת מחדל 12

מספר שלבי הסרת הרעש של המבנה הראשוני: שיפור איכות אפשרי משלבים נוספים כרוך בעיבוד איטי יותר.

ברירת מחדל 5

הגדר חדות מעבר באמצעות לוח הזמנים של רעש יצירת המבנה: הגדלת הערך מחדדת את המעברים.

ברירת מחדל 7.5

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

ברירת מחדל 0.5

הגדל הגדרה זו כאשר הגאומטריה נראית רועשת: היא מפחיתה פגמים הנגרמים מהכוונה חזקה בשלב הצורה.

ברירת מחדל 0.6

נקודת הפעלת ההנחיה ללא מסווג לעידון הצורה בשלב 2. היא מבוטאת כשבריר מהתקדמות הסרת הרעשים ומגדירה את interval_start; ההנחיה פועלת רק בחלון התחום על ידי interval_start ו-interval_end.

ברירת מחדל 1

סף ההנחיה לשלב 2 (עידון צורה): יש לבחור ערך גדול או שווה ל-shape_slat_guidance_interval_start. הערך מציין את שבר הסרת הרעשים שאליו מגיעים כאשר ההנחיה ללא מסווג נעצרת.

ברירת מחדל 12

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

ברירת מחדל 3

הגדר חדות של פרטים גאומטריים באמצעות לוח הזמנים של רעש עידון הצורה; הגדלת הערך מניבה פרטים חדים יותר.

ברירת מחדל 1

בקרת נאמנות צבע המרקם: היצמדות רבה יותר לצבעים בתמונת הקלט בהגדרות גבוהות מגבירה את החיוניות, אך עלולה לגרום לרוויית־יתר.

ברירת מחדל 0

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

ברירת מחדל 0.6

נקודת הפעלת ההנחיה ללא מסווג ליצירת מרקם בשלב 3. היא מבוטאת כשבריר מהתקדמות הסרת הרעשים ומגדירה את interval_start; ההנחיה פועלת רק בחלון התחום על ידי interval_start ו-interval_end.

ברירת מחדל 0.9

סף ההנחיה לשלב 3 (מרקם): יש לבחור ערך גדול או שווה ל-tex_slat_guidance_interval_start. הערך מציין את שבר הסרת הרעשים שאליו מגיעים כאשר ההנחיה ללא מסווג נעצרת.

ברירת מחדל 12

מספר שלבי הסרת הרעש המשמשים ליצירת מרקמים. הגדלת מספר השלבים אורכת זמן רב יותר אך עשויה להניב מרקמים נקיים יותר.

ברירת מחדל 3

הגדר חדות של פרטי המרקם באמצעות לוח הזמנים של רעש יצירת המרקם; הגדלת הערך מניבה פרטים חדים יותר.

ברירת מחדל 500000

יעד מספר הקודקודים ברשת, כאשר 500k מומלץ לשימוש כללי ו-20k–50k לאינטרנט ולמובייל. הקטנת היעד מחליפה פרטי רשת בקובצי פלט קטנים יותר.

ברירת מחדל 1

מידת התנועה המותרת בבנייה מחדש של הרשת: החלקה נוספת עלולה להקריב פרטים עדינים כאשר ערך זה גדל. ההגדרה מגבילה את תזוזת הקודקודים ביחס למשטח המקורי.

ברירת מחדל 0

עוצמת ההיטל להחזרת קודקודים שעברו בנייה מחדש אל המשטח המקורי: 1 משמר פרטים באמצעות היטל מלא, ואילו 0 משבית את ההיטל לתוצאה חלקה יותר.

ברירת מחדל 90

מגבלת זווית תרשים UV במעלות, המגבילה את ההבדל בין נורמלי פנים סמוכות בתוך תרשים אחד. העלאת המגבלה מעדיפה פחות תרשימים גדולים יותר, תוך סיכון למתיחה; הורדתה מעדיפה יותר תרשימים ופחות עיוות.

ברירת מחדל 0

מספר מעברי העידון המקומיים המשמשים לחישוב תרשימי UV.

ברירת מחדל 1

ניתן לשפר את איזון תרשימי ה-UV באמצעות הגדלת מספר מעברי האשכולות הגלובליים המשמשים לחישוב התרשימים.

ברירת מחדל 1

התאמת עוצמת ההחלקה של קצוות תרשימי ה-UV; הגדרות גבוהות יותר מפחיתות תפרים נראים לעין, אך כרוכות בסיכון לעיוות UV.

Seed המשמש ליצירה אקראית הניתנת לשחזור.

POST /run/trellis-2?wait=20 הצעת מחיר → ⁨‏0.30 ‏$⁩
# 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/trellis-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

מידע על Trellis 2

בונה נכס 3D מתמונה אחת (`image_url`) ומחזיר קובץ GLB. `resolution` הוא 512, 1024 או 1536, ו-`texture_size` הוא 1024, 2048 או 4096. לכל אחד משלושת השלבים (מבנה, צורה, טקסטורה) בקרות משלו להנחיה ולצעדי דגימה. `decimation_target` מגדיר את מספר קודקודי הרשת (5,000 עד 2,000,000), ונחשפות אפשרויות ל-remeshing ולפריסת UV.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
seedאופציונלי
סוגinteger | null
Seed המשמש ליצירה אקראית הניתנת לשחזור.
resolutionאופציונלי
סוגenum
ברירת מחדל1024
51210241536
רזולוציית הפלט; הגדלתה מוסיפה פרטים אך אורכת זמן רב יותר.
ss_guidance_strengthאופציונלי
סוגnumber
ברירת מחדל7.5
0 – 10
בקרת נאמנות של המבנה התלת־ממדי הראשוני: הגדלתה מעדיפה התאמה קרובה יותר לתמונת הקלט, במחיר של רעש נוסף אפשרי.
ss_guidance_rescaleאופציונלי
סוגnumber
ברירת מחדל0.7
0 – 1
בקרת פגמי הכוונה בשלב 1, המאזנת בין השפעות הכוונה חזקות בהגדרות נמוכות לבין פלט יציב יותר בהגדרות גבוהות.
ss_guidance_interval_startאופציונלי
סוגnumber
ברירת מחדל0.6
0 – 1
גבול ההתחלה של חלון ההנחיה ללא מסווג בשלב 1 (מבנה דליל), המבוטא כשבריר של הסרת הרעשים. הגדרות נמוכות יותר מתחילות את ההנחיה מוקדם יותר; רק המרווח מ-interval_start עד interval_end משתמש בהנחיה, ובשאר המקומות העיבוד אינו מונחה.
ss_guidance_interval_endאופציונלי
סוגnumber
ברירת מחדל1
0 – 1
סף ההנחיה לשלב 1 (מבנה דליל): יש לבחור ערך גדול או שווה ל-ss_guidance_interval_start. הערך מציין את שבר הסרת הרעשים שאליו מגיעים כאשר ההנחיה ללא מסווג נעצרת.
ss_sampling_stepsאופציונלי
סוגinteger
ברירת מחדל12
1 – 50
מספר שלבי הסרת הרעש של המבנה הראשוני: שיפור איכות אפשרי משלבים נוספים כרוך בעיבוד איטי יותר.
ss_rescale_tאופציונלי
סוגnumber
ברירת מחדל5
1 – 6
הגדר חדות מעבר באמצעות לוח הזמנים של רעש יצירת המבנה: הגדלת הערך מחדדת את המעברים.
shape_slat_guidance_strengthאופציונלי
סוגnumber
ברירת מחדל7.5
0 – 10
בקרת נאמנות של הגאומטריה המפורטת: היצמדות רבה יותר לתמונת הקלט מוסיפה פרטים, עם סיכון לרעש נוסף.
shape_slat_guidance_rescaleאופציונלי
סוגnumber
ברירת מחדל0.5
0 – 1
הגדל הגדרה זו כאשר הגאומטריה נראית רועשת: היא מפחיתה פגמים הנגרמים מהכוונה חזקה בשלב הצורה.
shape_slat_guidance_interval_startאופציונלי
סוגnumber
ברירת מחדל0.6
0 – 1
נקודת הפעלת ההנחיה ללא מסווג לעידון הצורה בשלב 2. היא מבוטאת כשבריר מהתקדמות הסרת הרעשים ומגדירה את interval_start; ההנחיה פועלת רק בחלון התחום על ידי interval_start ו-interval_end.
shape_slat_guidance_interval_endאופציונלי
סוגnumber
ברירת מחדל1
0 – 1
סף ההנחיה לשלב 2 (עידון צורה): יש לבחור ערך גדול או שווה ל-shape_slat_guidance_interval_start. הערך מציין את שבר הסרת הרעשים שאליו מגיעים כאשר ההנחיה ללא מסווג נעצרת.
shape_slat_sampling_stepsאופציונלי
סוגinteger
ברירת מחדל12
1 – 50
מספר שלבי הסרת הרעש לעידון הצורה: גאומטריה חלקה יותר עשויה לבוא על חשבון המהירות כאשר משתמשים בשלבים נוספים.
shape_slat_rescale_tאופציונלי
סוגnumber
ברירת מחדל3
1 – 6
הגדר חדות של פרטים גאומטריים באמצעות לוח הזמנים של רעש עידון הצורה; הגדלת הערך מניבה פרטים חדים יותר.
tex_slat_guidance_strengthאופציונלי
סוגnumber
ברירת מחדל1
0 – 10
בקרת נאמנות צבע המרקם: היצמדות רבה יותר לצבעים בתמונת הקלט בהגדרות גבוהות מגבירה את החיוניות, אך עלולה לגרום לרוויית־יתר.
tex_slat_guidance_rescaleאופציונלי
סוגnumber
ברירת מחדל0
0 – 1
הגדל הגדרה זו כדי לטפל במרקמים רועשים או בפסי צבע: היא מפחיתה פגמים הנגרמים מהכוונה חזקה בשלב המרקם.
tex_slat_guidance_interval_startאופציונלי
סוגnumber
ברירת מחדל0.6
0 – 1
נקודת הפעלת ההנחיה ללא מסווג ליצירת מרקם בשלב 3. היא מבוטאת כשבריר מהתקדמות הסרת הרעשים ומגדירה את interval_start; ההנחיה פועלת רק בחלון התחום על ידי interval_start ו-interval_end.
tex_slat_guidance_interval_endאופציונלי
סוגnumber
ברירת מחדל0.9
0 – 1
סף ההנחיה לשלב 3 (מרקם): יש לבחור ערך גדול או שווה ל-tex_slat_guidance_interval_start. הערך מציין את שבר הסרת הרעשים שאליו מגיעים כאשר ההנחיה ללא מסווג נעצרת.
tex_slat_sampling_stepsאופציונלי
סוגinteger
ברירת מחדל12
1 – 50
מספר שלבי הסרת הרעש המשמשים ליצירת מרקמים. הגדלת מספר השלבים אורכת זמן רב יותר אך עשויה להניב מרקמים נקיים יותר.
tex_slat_rescale_tאופציונלי
סוגnumber
ברירת מחדל3
1 – 6
הגדר חדות של פרטי המרקם באמצעות לוח הזמנים של רעש יצירת המרקם; הגדלת הערך מניבה פרטים חדים יותר.
decimation_targetאופציונלי
סוגinteger
ברירת מחדל500000
5,000 – 2,000,000
יעד מספר הקודקודים ברשת, כאשר 500k מומלץ לשימוש כללי ו-20k–50k לאינטרנט ולמובייל. הקטנת היעד מחליפה פרטי רשת בקובצי פלט קטנים יותר.
texture_sizeאופציונלי
סוגenum
ברירת מחדל2048
102420484096
רזולוציית מרקם הרשת לאפייה. פרטי משטח עדינים יותר יוצרים קבצים גדולים יותר כאשר מגדילים רזולוציה זו.
remeshאופציונלי
סוגboolean
ברירת מחדלtrue
בנייה מחדש של הטופולוגיה היוצרת משולשי רשת נקיים יותר, ובדרך כלל משפרת את ההתאמה לשימושים מאוחרים יותר כגון אנימציה או הדפסה תלת-ממדית, במחיר של עיבוד איטי יותר.
remesh_bandאופציונלי
סוגnumber
ברירת מחדל1
0 – 4
מידת התנועה המותרת בבנייה מחדש של הרשת: החלקה נוספת עלולה להקריב פרטים עדינים כאשר ערך זה גדל. ההגדרה מגבילה את תזוזת הקודקודים ביחס למשטח המקורי.
remesh_projectאופציונלי
סוגnumber
ברירת מחדל0
0 – 1
עוצמת ההיטל להחזרת קודקודים שעברו בנייה מחדש אל המשטח המקורי: 1 משמר פרטים באמצעות היטל מלא, ואילו 0 משבית את ההיטל לתוצאה חלקה יותר.
uv_unwrap_angle_threshold_degאופציונלי
סוגnumber
ברירת מחדל90
0 – 180
מגבלת זווית תרשים UV במעלות, המגבילה את ההבדל בין נורמלי פנים סמוכות בתוך תרשים אחד. העלאת המגבלה מעדיפה פחות תרשימים גדולים יותר, תוך סיכון למתיחה; הורדתה מעדיפה יותר תרשימים ופחות עיוות.
uv_unwrap_refine_iterationsאופציונלי
סוגinteger
ברירת מחדל0
0 – 10
מספר מעברי העידון המקומיים המשמשים לחישוב תרשימי UV.
uv_unwrap_global_iterationsאופציונלי
סוגinteger
ברירת מחדל1
1 – 10
ניתן לשפר את איזון תרשימי ה-UV באמצעות הגדלת מספר מעברי האשכולות הגלובליים המשמשים לחישוב התרשימים.
uv_unwrap_smooth_strengthאופציונלי
סוגnumber
ברירת מחדל1
0 – 10
התאמת עוצמת ההחלקה של קצוות תרשימי ה-UV; הגדרות גבוהות יותר מפחיתות תפרים נראים לעין, אך כרוכות בסיכון לעיוות UV.
image_urlחובה image
סוגurl · image
כתובת URL המפנה לתמונת המקור להמרה תלת־ממדית.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "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
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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 הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
model_glb
object {url, content_type, file_name, file_size}מודל תלת־ממדי שנוצר בפורמט GLB.

מודלים נוספים: תמונה ל-3D

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