דילוג לתוכן

Tripo P2 Image to 3D

שילוב

מזהה מודל tripo3d/p2/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/p2/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"

קבצים כמו בדוגמה: ⁨‏1.10 ‏$⁩ 1,100 קרדיטי API · ≈ ⁨‏118.34 ‏₽⁩ הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

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

תמונה ל-3D עם PBR, טופולוגיית quad, ארבע רמות איכות טקסטורה ובחירת גרסת טקסטורה

Tripo · 3D

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

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

בנה בקשה

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

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

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

texture_quality ברירת מחדל standard

הגדרת איכות הטקסטורות.

מתקדם texture_version · export_orientation · face_limit · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
texture_version

הגרסה המשמשת למידול טקסטורות. עבור איכות fast, יש לבחור ב-v3.5-20260815; גרסאות אחרות אינן נתמכות באיכות זו.

export_orientation

הגדרת ציר הקדימה לייצוא המודל, אם צוינה.

גבול עליון למספר פאות הרשת, עם מגבלה נפרדת של 25,000 עבור טופולוגיית quad.

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

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

POST /run/tripo3d/p2/image-to-3d?wait=20 הצעת מחיר → ⁨‏1.10 ‏$⁩
# 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/p2/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 P2 Image to 3D

הופך תמונה יחידה מ-`image_url` למודל 3D עם עד 50,000 פאות (25,000 ברשתות מצולעים quad). איכות הטקסטורה יכולה להיות fast, standard, detailed או extreme, ו-`texture_version` בוחר את מודל הטקסטורה. אפשרויות נוספות כוללות מפות PBR, הסרת תאורה, ייצוא UV, שינוי גודל אוטומטי וציר הכיוון הקדמי של הייצוא (`export_orientation`). גרעינים נפרדים שולטים בגאומטריה ובטקסטורות.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
image_urlחובה image
סוגurl · image
כתובת URL של תמונת קלט המשמשת ליצירת מודל תלת-ממד.
face_limitאופציונלי
סוגinteger | null
48 – 50,000
גבול עליון למספר פאות הרשת, עם מגבלה נפרדת של 25,000 עבור טופולוגיית quad.
textureאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם המודל מקבל מרקמים שנוצרו.
pbrאופציונלי
סוגboolean
ברירת מחדלtrue
שולט ביצירת מפות חומר PBR. הפעלת PBR מפעילה גם את הטקסטורות.
model_seedאופציונלי
סוגinteger | null
Seed המשמש להפיכת יצירת הגאומטריה לניתנת לשחזור.
texture_seedאופציונלי
סוגinteger | null
Seed המשמש להפיכת יצירת הטקסטורות לניתנת לשחזור.
texture_qualityאופציונלי
סוגenum
ברירת מחדלstandard
faststandarddetailedextreme
הגדרת איכות הטקסטורות.
texture_versionאופציונלי
סוגenum
v3.5-20260815v3.0-20250812v2.5-20250123
הגרסה המשמשת למידול טקסטורות. עבור איכות fast, יש לבחור ב-v3.5-20260815; גרסאות אחרות אינן נתמכות באיכות זו.
delightאופציונלי
סוגboolean
ברירת מחדלtrue
הסרת תאורה צרובה לפני הטקסטורה באמצעות v3.5-20260815.
auto_sizeאופציונלי
סוגboolean
ברירת מחדלfalse
קנה מידה אוטומטי להענקת ממדים מציאותיים למודל, הנמדדים במטרים.
export_uvאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם המודל יקבל קואורדינטות UV שנוצרו.
export_orientationאופציונלי
סוגenum
+x-x-y+y
הגדרת ציר הקדימה לייצוא המודל, אם צוינה.
quadאופציונלי
סוגboolean
ברירת מחדלfalse
טופולוגיית רשת המשתמשת במרובעים במקום במשולשים.
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/p2/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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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/p2/image-to-3d.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt