דילוג לתוכן

TRELLIS.2 LoRA Inference

שילוב

מזהה מודל trellis-2-lora
# 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-lora?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.25 ‏$⁩ 250 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Microsoft תמונה ל-3D

המרת תמונה ל-3D באמצעות Trellis 2, עם אפשרות להחלת מתאמי LoRA מותאמים למבנה, גאומטריה וטקסטורה

Microsoft · 3D

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

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

בנה בקשה

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

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

כתובת URL של תמונת המקור להמרה למודל תלת-ממד.

resolution ברירת מחדל 512

רזולוציית היצירה, כאשר 1024 בוחרת בצינור cascade. יש לבחור את הרזולוציה ששימשה לאימון מתאמי ה-LoRA שסופקו; נדרשת התאמה.

מתקדם texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · 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 · seed · enable_safety_checker

נקודת ביקורת אופציונלית של LoRA בפורמט safetensors, שאומנה במיוחד למסיר הרעשים של המרקם.

texture_size ברירת מחדל 2048

רזולוציית המרקמים שנאפו בייצוא GLB.

נקודת ביקורת אופציונלית של LoRA בפורמט safetensors, שאומנה במיוחד למסיר הרעשים של המבנה הדליל.

נקודת ביקורת אופציונלית של LoRA בפורמט safetensors, שאומנה במיוחד למסיר הרעשים של הגאומטריה.

ברירת מחדל 7.5

עוצמת ההנחיה ללא מסווג במהלך יצירת המבנה הדליל.

ברירת מחדל 0.7

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

ברירת מחדל 0.6

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

ברירת מחדל 1

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

ברירת מחדל 12

מספר צעדי הסרת הרעשים במהלך יצירת המבנה הדליל.

ברירת מחדל 5

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

ברירת מחדל 7.5

עוצמת ההנחיה ללא מסווג במהלך יצירת הצורה.

ברירת מחדל 0.5

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

ברירת מחדל 0.6

שבריר הסרת הרעשים שבו מתחילה הנחיית שלב הצורה.

ברירת מחדל 1

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

ברירת מחדל 12

מספר צעדי הסרת הרעשים במהלך יצירת הצורה.

ברירת מחדל 3

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

ברירת מחדל 1

עוצמת ההנחיה ללא מסווג במהלך יצירת המרקם.

ברירת מחדל 0

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

ברירת מחדל 0.6

שבריר הסרת הרעשים שבו מתחילה הנחיית שלב המרקם.

ברירת מחדל 0.9

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

ברירת מחדל 12

מספר צעדי הסרת הרעשים במהלך יצירת המרקם.

ברירת מחדל 3

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

ברירת מחדל 500000

מספר הקודקודים הרצוי בייצוא GLB.

seed אקראי שהופך את היצירה לניתנת לשחזור.

POST /run/trellis-2-lora?wait=20 הצעת מחיר → ⁨‏0.25 ‏$⁩
# 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-lora?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 LoRA Inference

מפיק GLB מ-`image_url`, עם אפשרות להחלת LoRA מסוג safetensors באמצעות `sparse_structure_lora_url`, `geometry_lora_url` ו-`texture_lora_url`. `resolution` הוא 512 או 1024 וחייב להתאים לרזולוציית האימון של המתאמים. נחשפות גם בקרות הנחיה וצעדים לכל שלב, `decimation_target` ו-`texture_size`.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
image_urlחובה image
סוגurl · image
כתובת URL של תמונת המקור להמרה למודל תלת-ממד.
sparse_structure_lora_urlאופציונלי
סוגstring | null
נקודת ביקורת אופציונלית של LoRA בפורמט safetensors, שאומנה במיוחד למסיר הרעשים של המבנה הדליל.
geometry_lora_urlאופציונלי
סוגstring | null
נקודת ביקורת אופציונלית של LoRA בפורמט safetensors, שאומנה במיוחד למסיר הרעשים של הגאומטריה.
texture_lora_urlאופציונלי
סוגstring | null
נקודת ביקורת אופציונלית של LoRA בפורמט safetensors, שאומנה במיוחד למסיר הרעשים של המרקם.
seedאופציונלי
סוגinteger | null
seed אקראי שהופך את היצירה לניתנת לשחזור.
resolutionאופציונלי
סוגenum
ברירת מחדל512
5121024
רזולוציית היצירה, כאשר 1024 בוחרת בצינור cascade. יש לבחור את הרזולוציה ששימשה לאימון מתאמי ה-LoRA שסופקו; נדרשת התאמה.
ss_guidance_strengthאופציונלי
סוגnumber
ברירת מחדל7.5
0 – 10
עוצמת ההנחיה ללא מסווג במהלך יצירת המבנה הדליל.
ss_guidance_rescaleאופציונלי
סוגnumber
ברירת מחדל0.7
0 – 1
שינוי קנה מידה של ההנחיה במהלך יצירת המבנה הדליל. ערכים גדולים יותר הופכים את הפלט ליציב יותר.
ss_guidance_interval_startאופציונלי
סוגnumber
ברירת מחדל0.6
0 – 1
שבריר מהתקדמות הסרת הרעשים שבו מתחילה הנחיית המבנה הדליל.
ss_guidance_interval_endאופציונלי
סוגnumber
ברירת מחדל1
0 – 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
שבריר הסרת הרעשים שבו מתחילה הנחיית שלב הצורה.
shape_slat_guidance_interval_endאופציונלי
סוגnumber
ברירת מחדל1
0 – 1
נקודת העצירה של הנחיית שלב הצורה, המבוטאת כשבריר הסרת רעשים שאינו קטן מ-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
שבריר הסרת הרעשים שבו מתחילה הנחיית שלב המרקם.
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
חדות לוח הזמנים של הרעש במהלך יצירת המרקם.
decimation_targetאופציונלי
סוגinteger
ברירת מחדל500000
5,000 – 2,000,000
מספר הקודקודים הרצוי בייצוא GLB.
texture_sizeאופציונלי
סוגenum
ברירת מחדל2048
102420484096
רזולוציית המרקמים שנאפו בייצוא GLB.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להקל את הסינון באמצעות הגדרה ל-false, אם הצד הקורא מורשה לכך.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "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": 250,
    "usd": "0.25",
    "charged": 250,
    "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
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "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 המכיל את המודל התלת-ממדי שנוצר.
seed
integerseed שהוחל במהלך היצירה.
resolution
integerהרזולוציה שבה בוצעה היצירה.
sparse_structure_lora_url
string | nullנקודת ביקורת של LoRA למבנה הדליל ששימשה במהלך היצירה, אם הוחלה.
geometry_lora_url
string | nullנקודת ביקורת של LoRA לגאומטריה ששימשה במהלך היצירה, אם הוחלה.
texture_lora_url
string | nullנקודת ביקורת של LoRA למרקם ששימשה במהלך היצירה, אם הוחלה.
decimation_target
integerיעד מספר הקודקודים שהוחל על ייצוא GLB.
texture_size
integerרזולוציית המרקמים שנאפו בייצוא GLB.

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