דילוג לתוכן

Tripo H3.1 Image to 3D

שילוב

מזהה מודל tripo3d/h3.1/image-to-3d
# 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/tripo3d/h3.1/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

קבצים כמו בדוגמה: ⁨‏0.30 ‏$⁩ 300 קרדיטי API · ≈ ⁨‏32.27 ‏₽⁩ הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

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

יצירת 3D מתמונה יחידה עם חומרי PBR, רשתות מרובעות ובקרת מספר פאות

Tripo · 3D

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

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

בנה בקשה

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

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

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

texture_quality ברירת מחדל standard

הגדרת איכות הטקסטורה; בחירה ב-'detailed' מגדילה את רזולוציית הטקסטורה.

geometry_quality ברירת מחדל standard

הגדרת האיכות של הגאומטריה.

מתקדם texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment ברירת מחדל original_image

ייחוס ליישור הטקסטורה: השתמשו ב-'geometry' עבור הגאומטריה שנוצרה או ב-'original_image' עבור תמונת הקלט.

orientation ברירת מחדל default

כיוון המודל; 'align_image' מסובב אותו אוטומטית כדי להתאים לתמונת הקלט.

יעד מפורש למספר הפאות ביצירת הרשת, העוקף את בחירת המספר האדפטיבית של המודל כאשר הוא מסופק.

Seed המשמש להפיכת יצירת הגאומטריה לניתנת לשחזור.

Seed המשמש להפיכת יצירת הטקסטורות לניתנת לשחזור.

POST /run/tripo3d/h3.1/image-to-3d?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.ru/v1/run/tripo3d/h3.1/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

מידע על Tripo H3.1 Image to 3D

בונה מודל 3D מתמונה אחת ב-`image_url`. האפשרויות כוללות `face_limit` (1,000 עד 2,000,000), `texture`, `pbr`, `texture_quality` ו-`geometry_quality` באיכות רגילה או מפורטת, טופולוגיית `quad`, `auto_size` ו-`orientation`. התוצאה כוללת רינדור תצוגה מקדימה ומזהה משימה להמשך ריגינג.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
image_urlחובה image
סוגurl · image
כתובת URL של תמונת קלט המשמשת ליצירת מודל תלת-ממד.
face_limitאופציונלי
סוגinteger | null
1,000 – 2,000,000
יעד מפורש למספר הפאות ביצירת הרשת, העוקף את בחירת המספר האדפטיבית של המודל כאשר הוא מסופק.
textureאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם המודל מקבל מרקמים שנוצרו.
pbrאופציונלי
סוגboolean
ברירת מחדלtrue
הפעלת חומרי PBR (Physically Based Rendering), שמפעילה גם יצירת טקסטורות כאשר הערך הוא true.
model_seedאופציונלי
סוגinteger | null
Seed המשמש להפיכת יצירת הגאומטריה לניתנת לשחזור.
texture_seedאופציונלי
סוגinteger | null
Seed המשמש להפיכת יצירת הטקסטורות לניתנת לשחזור.
texture_qualityאופציונלי
סוגenum
ברירת מחדלstandard
standarddetailed
הגדרת איכות הטקסטורה; בחירה ב-'detailed' מגדילה את רזולוציית הטקסטורה.
geometry_qualityאופציונלי
סוגenum
ברירת מחדלstandard
standarddetailed
הגדרת האיכות של הגאומטריה.
texture_alignmentאופציונלי
סוגenum
ברירת מחדלoriginal_image
original_imagegeometry
ייחוס ליישור הטקסטורה: השתמשו ב-'geometry' עבור הגאומטריה שנוצרה או ב-'original_image' עבור תמונת הקלט.
auto_sizeאופציונלי
סוגboolean
ברירת מחדלfalse
קנה מידה אוטומטי להענקת ממדים מציאותיים למודל, הנמדדים במטרים.
orientationאופציונלי
סוגenum
ברירת מחדלdefault
defaultalign_image
כיוון המודל; 'align_image' מסובב אותו אוטומטית כדי להתאים לתמונת הקלט.
quadאופציונלי
סוגboolean
ברירת מחדלfalse
בחירה בין פאות משולשות לבין מרובעים בעלי 4 צלעות באמצעות הפעלת טופולוגיית quad. עבור תוצאות quad, מוחזר קובץ FBX בכל פעם ש-Tripo מספק את הנתונים כבתים של FBX.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להקל את הסינון באמצעות הגדרה ל-false, אם הצד הקורא מורשה לכך.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/image-to-3d",
  "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_mesh": {
      "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
    },
    "model_urls": {
      "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
      },
      "fbx": {
        "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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_mesh
object {url, content_type, file_name, file_size}קובץ GLB או FBX המכיל את מודל התלת-ממד שנוצר, כשהפורמט נקבע לפי מה ש-Tripo מייצר.
model_urls
object {glb, fbx, base_model, pbr_model}כתובות URL המצביעות על גרסאות חלופיות של מודל התלת-ממד.
rendered_image
object {url, content_type, file_name, file_size} | nullתצוגה מקדימה מרונדרת המציגה את מודל התלת-ממד שנוצר.
task_id
string | nullמזהה משימה לשימוש חוזר של Tripo, המזהה את המודל שנוצר עבור rig או rig-check ומאפשר פעולות אלה ללא העלאה נוספת של מודל.

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

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