דילוג לתוכן

Trellis 2 · Retexture

שילוב

מזהה מודל trellis-2/retexture
# 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/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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.24 ‏$⁩ 240 קרדיטי API · ≈ ⁨‏25.31 ‏₽⁩ הרצה בדף הזה

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

מוסיף טקסטורה מחדש לרשת 3D קיימת ללא טקסטורה כדי להתאים לתמונת ייחוס, ומפיק GLB

Microsoft · 3D

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

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

בנה בקשה

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

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

כתובת URL של תמונת ייחוס המשמשת לטקסטור.

resolution ברירת מחדל 1024

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

•חובה

כתובת URL של המקור לטקסטור מחדש עבור רשת תלת-ממד ללא טקסטורה בפורמט GLB, OBJ, PLY או STL.

מתקדם texture_size · 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 · seed
texture_size ברירת מחדל 2048

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

ברירת מחדל 1

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

ברירת מחדל 0

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

ברירת מחדל 0.6

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

ברירת מחדל 0.9

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

ברירת מחדל 12

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

ברירת מחדל 3

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

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

POST /run/trellis-2/retexture?wait=20 הצעת מחיר → ⁨‏0.24 ‏$⁩
# 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/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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

מידע על Trellis 2 · Retexture

מחיל טקסטורה חדשה על הרשת שב-`mesh_url` (GLB, OBJ, PLY או STL) על סמך תמונת ייחוס `image_url`. `resolution` הוא 512 או 1024, ו-`texture_size` הוא 1024, 2048 או 4096. זמינות בקרות הנחיה ודגימה לשלב הטקסטורה. הגאומטריה אינה נוצרת מחדש.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
image_urlחובה image
סוגurl · image
כתובת URL של תמונת ייחוס המשמשת לטקסטור.
mesh_urlחובה
סוגstring
כתובת URL של המקור לטקסטור מחדש עבור רשת תלת-ממד ללא טקסטורה בפורמט GLB, OBJ, PLY או STL.
seedאופציונלי
סוגinteger | null
Seed המשמש ליצירה אקראית הניתנת לשחזור.
resolutionאופציונלי
סוגenum
ברירת מחדל1024
5121024
פרטי המרקם ומהירות העיבוד תלויים ברזולוציית היצירה הפנימית הזו: הגדלתה מפיקה פרטים עדינים יותר אך אורכת זמן רב יותר.
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
נקודת הפעלת ההנחיה ללא מסווג ליצירת מרקם. היא מבוטאת כשבריר מהתקדמות הסרת הרעשים ומגדירה את interval_start; ההנחיה פועלת רק בחלון התחום על ידי interval_start ו-interval_end.
tex_slat_guidance_interval_endאופציונלי
סוגnumber
ברירת מחדל0.9
0 – 1
גבול העצירה של ההנחיה ללא מסווג בשלב המרקם, המצוין כשבריר הסרת רעשים שאינו קטן מ-tex_slat_guidance_interval_start.
tex_slat_sampling_stepsאופציונלי
סוגinteger
ברירת מחדל12
1 – 50
מספר שלבי הסרת הרעש המשמשים ליצירת מרקמים. הגדלת מספר השלבים אורכת זמן רב יותר אך עשויה להניב מרקמים נקיים יותר.
tex_slat_rescale_tאופציונלי
סוגnumber
ברירת מחדל3
1 – 6
הגדר חדות של פרטי המרקם באמצעות לוח הזמנים של רעש יצירת המרקם; הגדלת הערך מניבה פרטים חדים יותר.
texture_sizeאופציונלי
סוגenum
ברירת מחדל2048
102420484096
רזולוציית מרקם הרשת לאפייה. פרטי משטח עדינים יותר יוצרים קבצים גדולים יותר כאשר מגדילים רזולוציה זו.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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.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 הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
model_glb
object {url, content_type, file_name, file_size}מודל תלת־ממדי שנוצר בפורמט GLB.

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

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