דילוג לתוכן

Hunyuan3d V3 · Image to 3D

שילוב

מזהה מודל hunyuan3d-v3/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/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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.375 ‏$⁩ 375 קרדיטי API · ≈ ⁨‏40.24 ‏₽⁩ הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

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

Hunyuan3D V3 מתמונה ל-3D עם תצוגות אחורית/שמאלית/ימנית אופציונליות, PBR ומצבי low-poly

Tencent · 3D

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

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

בנה בקשה

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

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

כתובת URL של תמונה המשמשת ליצירת מודל תלת־ממד.

גרור קובץ, או

כתובת URL של תמונה מהמבט האחורי, שניתן לספק לשיפור השחזור התלת־ממדי.

גרור קובץ, או

כתובת URL של תמונה מהמבט השמאלי, שניתן לספק לשיפור השחזור התלת־ממדי.

גרור קובץ, או

כתובת URL של תמונה מהמבט הימני, שניתן לספק לשיפור השחזור התלת־ממדי.

generate_type ברירת מחדל Normal

מצב יצירה: `Normal` יוצר מודל עם טקסטורה; `LowPoly` מפחית מצולעים; `Geometry` יוצר מודל לבן ללא טקסטורה.

ברירת מחדל 500000

מספר הפאות הרצוי, בטווח 40,000 עד 1,500,000.

מתקדם polygon_type · enable_safety_checker
polygon_type ברירת מחדל triangle

סוג המצולעים, מוחל רק כאשר `GenerateType` הוא `LowPoly`.

POST /run/hunyuan3d-v3/image-to-3d?wait=20 הצעת מחיר → ⁨‏0.375 ‏$⁩
# 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/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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

מידע על Hunyuan3d V3 · Image to 3D

יוצר מודל 3D מ-`input_image_url`, עם `back_image_url`, `left_image_url` ו-`right_image_url` אופציונליים לשיפור השחזור. `generate_type` בוחר Normal, LowPoly או Geometry (ללא טקסטורה), ו-`polygon_type` בוחר משולש או מרובע עבור LowPoly. `enable_pbr` מוסיף חומרי PBR ו-`face_count` נע בין 40000 ל-1500000. מחזיר GLB, כתובות URL לפורמטים נוספים ותמונה ממוזערת.

פרמטרים

שםסוג ברירת מחדלמותר תיאור
input_image_urlחובה
סוגurl · image
כתובת URL של תמונה המשמשת ליצירת מודל תלת־ממד.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להקל את הסינון באמצעות הגדרה ל-false, אם הצד הקורא מורשה לכך.
back_image_urlאופציונלי
סוגurl · image
כתובת URL של תמונה מהמבט האחורי, שניתן לספק לשיפור השחזור התלת־ממדי.
left_image_urlאופציונלי
סוגurl · image
כתובת URL של תמונה מהמבט השמאלי, שניתן לספק לשיפור השחזור התלת־ממדי.
right_image_urlאופציונלי
סוגurl · image
כתובת URL של תמונה מהמבט הימני, שניתן לספק לשיפור השחזור התלת־ממדי.
enable_pbrאופציונלי
סוגboolean
ברירת מחדלfalse
יוצר חומרי PBR אלא אם generate_type הוא Geometry; במקרה זה להגדרה אין השפעה.
face_countאופציונלי
סוגinteger
ברירת מחדל500000
40,000 – 1,500,000
מספר הפאות הרצוי, בטווח 40,000 עד 1,500,000.
generate_typeאופציונלי
סוגenum
ברירת מחדלNormal
NormalLowPolyGeometry
מצב יצירה: `Normal` יוצר מודל עם טקסטורה; `LowPoly` מפחית מצולעים; `Geometry` יוצר מודל לבן ללא טקסטורה.
polygon_typeאופציונלי
סוגenum
ברירת מחדלtriangle
trianglequadrilateral
סוג המצולעים, מוחל רק כאשר `GenerateType` הוא `LowPoly`.
חובה

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "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
    },
    "thumbnail": {
      "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
  },
  "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 המכיל את אובייקט התלת-ממד שנוצר.
thumbnail
object {url, content_type, file_name, file_size} | nullתמונה ממוזערת המציגה תצוגה מקדימה של המודל שנוצר.
model_urls
object {glb, fbx, obj, usdz}קישורים למודל התלת-ממד בפורמטים שונים.
seed
integer | nullערך ה-Seed ששימש במהלך היצירה.

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

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