အကြောင်းအရာသို့ ကျော်ရန်

Hyper3D - Rodin V2.5 - Image to 3D

ပေါင်းစည်းရန်

မော်ဒယ် id hyper3d/rodin/v2.5
# 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/hyper3d/rodin/v2.5?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ဤတောင်းဆိုချက်: ၀.၄၀ $ ၄၀၀ API ခရက်ဒစ် ဤစာမျက်နှာတွင် လုပ်ဆောင်ရန်

API ကီး ရယူရန်
Hyper3D ပုံမှ 3D 4K ထွက်ရလဒ်မြန်ဆန် #image-to-3d

ကိုးကားပုံ 5 ပုံအထိ အသုံးပြု၍ အရည်အသွေးအဆင့်များထဲမှ ရွေးချယ်နိုင်သော Rodin V2.5 ဖြင့် ပုံမှ 3D ဖန်တီးမှု

Hyper3D · 3D

သင့်ပထမဆုံးရလဒ် ဤနေရာတွင် ပေါ်လာမည်

အောက်တွင် တောင်းဆိုချက်တစ်ခု တည်ဆောက်ပြီး သင့် API ကီးဖြင့် လုပ်ဆောင်ပါ။ ထွက်ရလဒ်များကို ကျွန်ုပ်တို့၏ သိုလှောင်မှုသို့ ကူးယူပြီး အမြဲတမ်း သို့မဟုတ် ၇ ရက် အခမဲ့ သိမ်းထားသည်။

တောင်းဆိုမှုတစ်ခု တည်ဆောက်ရန်

ထိန်းချုပ်မှုများကို မော်ဒယ် schema မှ အလိုအလျောက်ဖန်တီးသည်။ ၎င်းတို့ကို ပြောင်းလဲသည်နှင့် code နှင့် စျေးနှုန်းတို့လည်း ပြောင်းလဲမည်။

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 · addons
image_urls
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ် · 5 အထိ

မော်ဒယ်ဖန်တီးရန် အသုံးပြုသည့် မူရင်းပုံ URL များ။ ပုံ 5 ပုံအထိ ကန့်သတ်ထားပြီး Image-to-3D မုဒ်တွင် မဖြစ်မနေလိုအပ်သည်။

geometry_file_format မူလ glb

glb၊ usdz၊ fbx၊ obj၊ stl တို့ထဲမှ ရွေးချယ်သည့် ဂျီဩမေတြီဖိုင်ဖော်မတ်။ မူလတန်ဖိုးမှာ glb ဖြစ်သည်။

material မူလ All

ပစ္စည်းထွက်ရလဒ် ရွေးချယ်မှု။ Texture မပါသော ဂျီဩမေတြီအတွက် None ကို ရွေးပါ၊ ပစ္စည်းအမျိုးအစားနှစ်မျိုးလုံး ရရှိရန် All ကို ရွေးပါ။ Physically based ပစ္စည်းများဖြင့် လက်တွေ့ဆန်သော အလင်းရောင်အတွက် PBR၊ PBR maps မပါသော baked lighting အတွက် Shaded ကို ရွေးပါ။

texture_mode

Texture အရည်အသွေးကို တိကျစွာ ရွေးချယ်ပါ၊ သို့မဟုတ် အဆင့်နှင့် သင့်လျော်သော မူလတန်ဖိုးကို အသုံးပြုသည့် API ထံ ရွေးချယ်ခွင့်ကို ချန်ထားပါ။

မူလ Gen-2.5-High

Mesh အသေးစိတ်အဆင့်။ အဆင့်မြှင့်လျှင် အသေးစိတ်ပိုမိုရရှိသော်လည်း Gen-2.5-Minimum သည် minimum mode ကို အလိုအလျောက်ဖွင့်ပြီး quality_mesh_option မည်သို့ပင်ဖြစ်စေ 50K Triangle ကို သတ်မှတ်သည်။ အသေးစိတ်များကို [စာရွက်စာတမ်းများ](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) တွင် ကြည့်ပါ။

မူလ Auto

Mesh topology နှင့် အရည်အသွေး။ ရရှိနိုင်သော face အရေအတွက်ကို အဆင့်က သတ်မှတ်သည်။ Extreme-Low၊ Low နှင့် Medium သည် 1M Triangle အထိ ခွင့်ပြုပြီး High နှင့် Extreme-High သည် 20K Triangle မှ 2M Triangle အထိ ပံ့ပိုးသည်။ Auto သည် အောက်ပါ အကြံပြုတန်ဖိုးများကို သတ်မှတ်သည် - 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle။ ကိုယ်တိုင်ရွေးချယ်ရာတွင် Quad သည် ချောမွေ့သော မျက်နှာပြင်များကို ဦးစားပေးပြီး Triangle သည် အသေးစိတ်ဂျီဩမေတြီကို ဦးစားပေးသည်။ Hyper3D API သို့ topology ကို `mesh_mode` (Quad/Raw) အဖြစ်၊ face အရေအတွက်ကို `quality_override` အဖြစ် ပေးပို့သည်။

0–65535 အတွင်း ရွေးချယ်နိုင်သော ကျပန်းပြုလုပ်မှု seed။

ControlNet အသုံးပြု၍ ဖန်တီးမည့် မော်ဒယ်၏ အရွယ်အစားကို ကန့်သတ်ပါ။

ရွေးချယ်နိုင်သော add-on ကို စာရင်းအဖြစ် သို့မဟုတ် add-on တစ်ခုတည်းဖြစ်လျှင် တန်ဖိုးတစ်ခုတည်းအဖြစ် ပေးပို့နိုင်သည်။

POST /run/hyper3d/rodin/v2.5?wait=20 ကုန်ကျစရိတ် → ၀.၄၀ $
# 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/hyper3d/rodin/v2.5?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ဤတောင်းဆိုချက်ကို လုပ်ဆောင်ရန်

သင့် key သည် ဤဘရောက်ဇာထဲတွင်သာ ရှိမည်ဖြစ်ပြီး Doitong API သို့သာ ပို့မည်။ Remember ကို အမှန်ခြစ်ထားမှသာ (localStorage) တွင် သိမ်းမည်။ API ကီး ရယူရန်

Hyper3D - Rodin V2.5 - Image to 3D အကြောင်း

`image_urls` ရှိ ပုံ 1 မှ 5 ပုံအထိ အသုံးပြုပြီး 3D မော်ဒယ်ကို တည်ဆောက်ပေးသည်။ စာလုံးရေ 1024 အထိရှိသော `prompt` ကိုလည်း ထည့်ပေးနိုင်သည်။ အဆင့် 6 ဆင့်သည် Gen-2.5-Minimum မှ Gen-2.5-Extreme-High အထိရှိပြီး မူလတန်ဖိုးမှာ High ဖြစ်သည်။ ရွေးချယ်စရာများတွင် ဂျီဩမေတြီဖော်မတ် (glb, usdz, fbx, obj, stl)၊ `material`၊ လေးထောင့် သို့မဟုတ် တြိဂံ မက်ရှ်အရွယ်အစားများ၊ အရိုးဖွဲ့စည်းပုံ တပ်ဆင်ရလွယ်သော ဇာတ်ကောင်များအတွက် `TAPose` နှင့် `hd_texture` တို့ ပါဝင်သည်။

ပါရာမီတာများ

စံအမည် သို့မဟုတ် မူရင်းအမည် တစ်ခုခုကိုသာ ပို့ပါ၊ နှစ်ခုလုံး မပို့ပါနှင့်။ စံအမည်များ

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
promptရွေးချယ်နိုင်သည်
အမျိုးအစားstring
မူလတန်ဖိုး
စာလုံး ၁,၀၂၄ လုံးထက် မပိုပါ
စာသားဖြင့် ဖန်တီးမှုကို လမ်းညွှန်ပါ၊ သို့မဟုတ် Image-to-3D မုဒ်တွင် ဤနေရာကို ဗလာထားခြင်းဖြင့် ပုံများမှ ပရောမ့်ကို မော်ဒယ်က အလိုအလျောက် ရယူစေပါ။
image_urlsရွေးချယ်နိုင်သည် images
အမျိုးအစားurl[] · image
အကြောင်းအရာ ၅ ခုထက် မပိုပါ
မော်ဒယ်ဖန်တီးရန် အသုံးပြုသည့် မူရင်းပုံ URL များ။ ပုံ 5 ပုံအထိ ကန့်သတ်ထားပြီး Image-to-3D မုဒ်တွင် မဖြစ်မနေလိုအပ်သည်။
tierရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Mesh အသေးစိတ်အဆင့်။ အဆင့်မြှင့်လျှင် အသေးစိတ်ပိုမိုရရှိသော်လည်း Gen-2.5-Minimum သည် minimum mode ကို အလိုအလျောက်ဖွင့်ပြီး quality_mesh_option မည်သို့ပင်ဖြစ်စေ 50K Triangle ကို သတ်မှတ်သည်။ အသေးစိတ်များကို [စာရွက်စာတမ်းများ](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) တွင် ကြည့်ပါ။
use_original_alphaရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
3D အကြောင်းအရာဖန်တီးရာတွင် ထည့်သွင်းသည့်ပုံ၏ transparency channels များကို ထိန်းသိမ်းမည်၊ မည်မည်ကို ထိန်းချုပ်သည်။
seedရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
၀ – ၆၅,၅၃၅
0–65535 အတွင်း ရွေးချယ်နိုင်သော ကျပန်းပြုလုပ်မှု seed။
geometry_file_formatရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးglb
glbusdzfbxobjstl
glb၊ usdz၊ fbx၊ obj၊ stl တို့ထဲမှ ရွေးချယ်သည့် ဂျီဩမေတြီဖိုင်ဖော်မတ်။ မူလတန်ဖိုးမှာ glb ဖြစ်သည်။
materialရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးAll
PBRShadedAllNone
ပစ္စည်းထွက်ရလဒ် ရွေးချယ်မှု။ Texture မပါသော ဂျီဩမေတြီအတွက် None ကို ရွေးပါ၊ ပစ္စည်းအမျိုးအစားနှစ်မျိုးလုံး ရရှိရန် All ကို ရွေးပါ။ Physically based ပစ္စည်းများဖြင့် လက်တွေ့ဆန်သော အလင်းရောင်အတွက် PBR၊ PBR maps မပါသော baked lighting အတွက် Shaded ကို ရွေးပါ။
quality_mesh_optionရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh topology နှင့် အရည်အသွေး။ ရရှိနိုင်သော face အရေအတွက်ကို အဆင့်က သတ်မှတ်သည်။ Extreme-Low၊ Low နှင့် Medium သည် 1M Triangle အထိ ခွင့်ပြုပြီး High နှင့် Extreme-High သည် 20K Triangle မှ 2M Triangle အထိ ပံ့ပိုးသည်။ Auto သည် အောက်ပါ အကြံပြုတန်ဖိုးများကို သတ်မှတ်သည် - 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle။ ကိုယ်တိုင်ရွေးချယ်ရာတွင် Quad သည် ချောမွေ့သော မျက်နှာပြင်များကို ဦးစားပေးပြီး Triangle သည် အသေးစိတ်ဂျီဩမေတြီကို ဦးစားပေးသည်။ Hyper3D API သို့ topology ကို `mesh_mode` (Quad/Raw) အဖြစ်၊ face အရေအတွက်ကို `quality_override` အဖြစ် ပေးပို့သည်။
texture_modeရွေးချယ်နိုင်သည်
အမျိုးအစားenum
legacyextreme-lowlowmediumhigh
Texture အရည်အသွေးကို တိကျစွာ ရွေးချယ်ပါ၊ သို့မဟုတ် အဆင့်နှင့် သင့်လျော်သော မူလတန်ဖိုးကို အသုံးပြုသည့် API ထံ ရွေးချယ်ခွင့်ကို ချန်ထားပါ။
enable_creative_modeရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
Hyper3D API တွင် `geometry_instruct_mode` ကို `creative` ဟု သတ်မှတ်ထားခြင်းနှင့် တူညီသော ဖန်တီးမှုမုဒ်။ ၎င်းကို ဖွင့်ခြင်းဖြင့် ထွက်ရလဒ်တစ်သမတ်တည်းရှိမှုကို မထိခိုက်စေဘဲ ဖန်တီးမှု ပိုမိုခိုင်မာလာသည်။
hd_textureရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
မြင်ကွင်းတိကျမှု မြှင့်တင်ရန် အဆင့်မြင့် texture post-processing ကို ထိန်းချုပ်သည်။
texture_delightရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
ဖန်တီးထားသော textures များထဲမှ baked-in illumination နှင့် highlights များကို ဖယ်ရှားသည်။
is_microရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
micro scale တွင် ပိုမိုနူးညံ့သော ဂျီဩမေတြီအသေးစိတ်ကို ထည့်ပေးသည်။ `tier="Gen-2.5-Extreme-High"` ဖြစ်မှသာ အကျိုးသက်ရောက်သည်။
TAPoseရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
3D ဆော့ဖ်ဝဲတွင် rigging နှင့် animation ပိုမိုလွယ်ကူစေရန် ဇာတ်ကောင် pose သတ်မှတ်ချက်။ ဖွင့်ထားလျှင် ဇာတ်ကောင်များကို T-pose သို့မဟုတ် A-pose ဖြင့် ဖန်တီးသည်။
bbox_conditionရွေးချယ်နိုင်သည်
အမျိုးအစားobject
ControlNet အသုံးပြု၍ ဖန်တီးမည့် မော်ဒယ်၏ အရွယ်အစားကို ကန့်သတ်ပါ။
bbox_condition.widthရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး0
၁ – ၂,၀၄၈
x axis တစ်လျှောက် bounding box ကန့်သတ်ချက်အကျယ်။
bbox_condition.heightရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး0
၁ – ၂,၀၄၈
y axis တစ်လျှောက် bounding box ကန့်သတ်ချက်အမြင့်။
bbox_condition.lengthရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး0
၁ – ၂,၀၄၈
z axis တစ်လျှောက် bounding box ကန့်သတ်ချက်အလျား။
addonsရွေးချယ်နိုင်သည်
အမျိုးအစားobject
ရွေးချယ်နိုင်သော add-on ကို စာရင်းအဖြစ် သို့မဟုတ် add-on တစ်ခုတည်းဖြစ်လျှင် တန်ဖိုးတစ်ခုတည်းအဖြစ် ပေးပို့နိုင်သည်။
addons.high_packရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
HighPack မြှင့်တင်မှု။ Quad ထွက်ရလဒ်တွင် quality ပါရာမီတာမှ တောင်းဆိုထားသော face အရေအတွက်၏ ခန့်မှန်းခြေ 16 ဆ ပါဝင်ပြီး textures သည် မူလ 2K အစား 4K ရုပ်ထွက်အရည်အသွေးကို အသုံးပြုသည်။
preview_renderရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
ပေးပို့သည့် မော်ဒယ်ဖိုင်များတွင် ဖန်တီးထားသော 3D မော်ဒယ်ကို ပြသသည့် ပုံတစ်ပုံ ထည့်ပေးသော preview-render toggle။
enable_safety_checkerရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
caller က ခွင့်ပြုချက်ရှိပါက false သတ်မှတ်ခြင်းဖြင့် စစ်ဆေးမှုကို လျှော့ချနိုင်သည်။
လိုအပ်သည် စံအမည်၊ ထို့အပြင် လက်ခံသည်

ဖိုင်ပါရာမီတာများသည် အများပြည်သူသုံး https:// URL၊ 10 MB အထိ data: URI သို့မဟုတ် အပ်လုဒ်လုပ်ထားသောဖိုင်၏ file_url ကို လက်ခံသည်။ ဖိုင်များ

ထွက်ရလဒ်

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
သင့်ဖိုင်များ၊ သင့်ရွေးချယ်မှုoutputs[].url တိုင်းသည် ကျွန်ုပ်တို့၏ သိုလှောင်မှုရှိ မိတ္တူဖြစ်သည်- အမြဲတမ်း (GB-month အလိုက် ငွေပေးရသည်) သို့မဟုတ် ၇ ရက် အခမဲ့၊ သင့်အကောင့်ဆက်တင် သို့မဟုတ် ?storage= ဖြင့် သိမ်းထားသည်။
မော်ဒယ်တိုင်းတွင် ပုံစံတူပုံ၊ ဗီဒီယိုနှင့် အသံတို့အတွက် type၊ url၊ content_type၊ width၊ height နှင့် duration။ output သည် မော်ဒယ်ကိုယ်တိုင်၏ ရလဒ် object ဖြစ်သည်။
ထွက်ရလဒ်၏ Fields များ
model_mesh
object {url, content_type, file_name, file_size}ဖန်တီးထားသော 3D အရာဝတ္ထုပါဝင်သည့် ဖိုင်။
model_meshes
array of object {url, content_type, file_name, file_size}Hyper3D က ဖန်တီးပြီး model_mesh အပြင် ထပ်မံပြန်ပို့သော 3D အရာဝတ္ထုဖိုင်များ။
seed
integerဖန်တီးမှုအတွင်း အသုံးပြုမည့် seed။
textures
array of object {url, content_type, file_name, file_size, width, height}3D အရာဝတ္ထုအတွက် ထုတ်လုပ်ထားသော textures။

နောက်ထပ် မော်ဒယ်များ: ပုံမှ 3D

AI အေးဂျင့်များအတွက်- ဤစာမျက်နှာ၏ Markdown ကို ဤနေရာတွင် ရရှိနိုင်သည် https://doitong.com/my/developers/models/hyper3d/rodin/v2.5.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt