דילוג לתוכן

Hyper3D - Rodin V2.5 - Image to 3D - Fast

שילוב

מזהה מודל hyper3d/rodin/v2.5/fast
# 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/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

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

קבלת מפתח API
Hyper3D תמונה ל-3D פלט 4Kמהיר #image-to-3d

Rodin V2.5 מהיר יותר מתמונה ל-3D, מוגבל לשלוש מדרגות האיכות הנמוכות ביותר לאב-טיפוס מהיר

Hyper3D · 3D

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

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

בנה בקשה

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

0 / 1024

הנחה את היצירה באמצעות טקסט, או אפשר למודל להפיק הנחיה אוטומטית מהתמונות באמצעות השארת שדה זה ריק במצב Image-to-3D.

מתקדם images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition
image_urls
גרור קובץ, או · עד 5

כתובות URL של תמונות מקור, מוגבלות ל־5 תמונות ונדרשות במצב Image-to-3D ליצירת המודל.

geometry_file_format ברירת מחדל glb

פורמט קובץ הגאומטריה, נבחר מתוך glb, usdz, fbx, obj, stl; ברירת המחדל היא glb.

material ברירת מחדל Shaded

בחירת פלט החומרים: בחר None לגאומטריה ללא טקסטורות, או All לקבלת שתי גרסאות החומר. לתאורה מציאותית עם חומרים מבוססי־פיזיקה בחר PBR; לתאורה אפויה ללא מפות PBR בחר Shaded.

texture_mode

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

ברירת מחדל Gen-2.5-Extreme-Low

שכבת היצירה; Gen-2.5-Minimum כופה מצב minimum ורשת 50K Triangle ללא קשר ל־`quality_mesh_option`. פרטי השכבות זמינים ב־[תיעוד Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

ברירת מחדל Auto

בחר איכות יחד עם טופולוגיית הרשת: Quad מעדיף משטחים חלקים, ואילו Triangle מעדיף פירוט גאומטרי. נקודת הקצה המהירה מיועדת בעיקר לבדיקה ולאב־טיפוס, עם מגבלה של 20K; השתמש בנקודת הקצה הרגילה לרשתות באיכות גבוהה יותר, שבה Minimum, Extreme-Low ו־Low תומכות בעד 1M Triangle, כאשר מספרי הפאות הזמינים תלויים בשכבה. ב־Hyper3D API, `quality_override` מציין את מספר הפאות, ואילו `mesh_mode` מציין Quad/Raw. Auto בוחרת בהגדרות המומלצות: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

סיד אקראי אופציונלי בטווח 0–65535.

הגבל את גודל המודל שנוצר באמצעות ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 הצעת מחיר → ⁨‏0.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/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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

מידע על Hyper3D - Rodin V2.5 - Image to 3D - Fast

יוצר מודל 3D מתמונה אחת עד חמש תמונות ב-`image_urls`, עם `prompt` אופציונלי. `tier` מוגבל ל-Minimum, Extreme-Low (ברירת מחדל) ו-Low, ואפשרויות הרשת מגיעות עד 20K פאות. חומר ברירת המחדל הוא Shaded. פורמטי הפלט הם glb, usdz, fbx, obj או stl.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
image_urlsאופציונלי images
סוגurl[] · image
≤ 5 פריטים
כתובות URL של תמונות מקור, מוגבלות ל־5 תמונות ונדרשות במצב Image-to-3D ליצירת המודל.
tierאופציונלי
סוגenum
ברירת מחדלGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
שכבת היצירה; Gen-2.5-Minimum כופה מצב minimum ורשת 50K Triangle ללא קשר ל־`quality_mesh_option`. פרטי השכבות זמינים ב־[תיעוד Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptאופציונלי
סוגstring
ברירת מחדל
≤ 1,024 תווים
הנחה את היצירה באמצעות טקסט, או אפשר למודל להפיק הנחיה אוטומטית מהתמונות באמצעות השארת שדה זה ריק במצב Image-to-3D.
use_original_alphaאופציונלי
סוגboolean
ברירת מחדלfalse
שולט בשימור ערוצי השקיפות של תמונת הקלט בעת יצירת תוכן תלת־ממדי.
seedאופציונלי
סוגinteger | null
0 – 65,535
סיד אקראי אופציונלי בטווח 0–65535.
geometry_file_formatאופציונלי
סוגenum
ברירת מחדלglb
glbusdzfbxobjstl
פורמט קובץ הגאומטריה, נבחר מתוך glb, usdz, fbx, obj, stl; ברירת המחדל היא glb.
materialאופציונלי
סוגenum
ברירת מחדלShaded
PBRShadedAllNone
בחירת פלט החומרים: בחר None לגאומטריה ללא טקסטורות, או All לקבלת שתי גרסאות החומר. לתאורה מציאותית עם חומרים מבוססי־פיזיקה בחר PBR; לתאורה אפויה ללא מפות PBR בחר Shaded.
quality_mesh_optionאופציונלי
סוגenum
ברירת מחדלAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
בחר איכות יחד עם טופולוגיית הרשת: Quad מעדיף משטחים חלקים, ואילו Triangle מעדיף פירוט גאומטרי. נקודת הקצה המהירה מיועדת בעיקר לבדיקה ולאב־טיפוס, עם מגבלה של 20K; השתמש בנקודת הקצה הרגילה לרשתות באיכות גבוהה יותר, שבה Minimum, Extreme-Low ו־Low תומכות בעד 1M Triangle, כאשר מספרי הפאות הזמינים תלויים בשכבה. ב־Hyper3D API, `quality_override` מציין את מספר הפאות, ואילו `mesh_mode` מציין Quad/Raw. Auto בוחרת בהגדרות המומלצות: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeאופציונלי
סוגenum
legacyextreme-lowlowmediumhigh
בחר את איכות הטקסטורה במפורש או השאר את הבחירה ל־API, המשתמש בברירת מחדל המתאימה לשכבה.
enable_creative_modeאופציונלי
סוגboolean
ברירת מחדלfalse
מצב יצירה יצירתי, השקול ל־`geometry_instruct_mode` המוגדר ל־`creative` ב־Hyper3D API. הפעלתו הופכת את היצירה לעמידה יותר בלי לפגוע בעקביות הפלט.
hd_textureאופציונלי
סוגboolean
ברירת מחדלfalse
שולט בעיבוד מתקדם לאחר יצירת הטקסטורה לשיפור הנאמנות החזותית.
texture_delightאופציונלי
סוגboolean
ברירת מחדלfalse
מסיר מהטקסטורות שנוצרו תאורה והדגשות שנצרבו מראש.
is_microאופציונלי
סוגboolean
ברירת מחדלfalse
מוסיף פירוט גאומטרי עדין בקנה מידה מיקרו; נכנס לתוקף רק כאשר `tier="Gen-2.5-Extreme-High"`.
TAPoseאופציונלי
סוגboolean
ברירת מחדלfalse
הגדרת תנוחת הדמות להקלה על ריגינג ואנימציה בתוכנת תלת־ממד: הפעלתה יוצרת דמויות בתנוחת T או A.
bbox_conditionאופציונלי
סוגobject
הגבל את גודל המודל שנוצר באמצעות ControlNet.
bbox_condition.widthאופציונלי
סוגinteger
ברירת מחדל0
1 – 2,048
רוחב אילוץ התיבה התוחמת לאורך ציר x.
bbox_condition.heightאופציונלי
סוגinteger
ברירת מחדל0
1 – 2,048
גובה אילוץ התיבה התוחמת לאורך ציר y.
bbox_condition.lengthאופציונלי
סוגinteger
ברירת מחדל0
1 – 2,048
אורך אילוץ התיבה התוחמת לאורך ציר z.
preview_renderאופציונלי
סוג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": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "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_meshes": [
      {
        "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,
    "textures": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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}קובץ המכיל את האובייקט התלת־ממדי שנוצר.
model_meshes
array of object {url, content_type, file_name, file_size}קובצי אובייקטים תלת־ממדיים נוספים שנוצרו על ידי Hyper3D ומוחזרים בנוסף ל־model_mesh.
seed
integerSeed שהוחל במהלך היצירה.
textures
array of object {url, content_type, file_name, file_size, width, height}טקסטורות שנוצרו עבור האובייקט התלת־ממדי.

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

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/hyper3d/rodin/v2.5/fast.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt