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

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

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

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

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

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

မြန်ဆန်သော prototype ဖန်တီးရန် အနိမ့်ဆုံးအဆင့် 3 ခုအထိသာ ကန့်သတ်ထားသော ပိုမြန်သည့် 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
image_urls
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ် · 5 အထိ

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

geometry_file_format မူလ glb

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

material မူလ Shaded

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

texture_mode

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

မူလ Gen-2.5-Extreme-Low

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

မူလ Auto

Mesh topology နှင့်အတူ အရည်အသွေးကို ရွေးချယ်ပါ။ Quad သည် ချောမွေ့သော မျက်နှာပြင်များကို ဦးစားပေးပြီး Triangle သည် ဂျီဩမေတြီအသေးစိတ်ကို ဦးစားပေးသည်။ fast Endpoint သည် စမ်းသပ်ခြင်းနှင့် prototype ပြုလုပ်ခြင်းအတွက် အဓိကရည်ရွယ်ပြီး 20K ကန့်သတ်ချက်ရှိသည်။ အရည်အသွေးမြင့် mesh များအတွက် standard Endpoint ကို အသုံးပြုပါ။ ထိုနေရာတွင် Minimum၊ Extreme-Low နှင့် Low သည် 1M Triangle အထိ ပံ့ပိုးပြီး ရရှိနိုင်သော face အရေအတွက်မှာ အဆင့်အလိုက် ကွဲပြားသည်။ Hyper3D API တွင် `quality_override` သည် face အရေအတွက်ကို သတ်မှတ်ပြီး `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 အတွင်း ရွေးချယ်နိုင်သော ကျပန်းပြုလုပ်မှု seed။

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

POST /run/hyper3d/rodin/v2.5/fast?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/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.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 - Fast အကြောင်း

`image_urls` ရှိ ပုံတစ်ပုံမှ ငါးပုံအထိမှ 3D မော်ဒယ်ကို ဖန်တီးပေးပြီး `prompt` ကို ရွေးချယ်ထည့်နိုင်သည်။ `tier` သည် Minimum၊ Extreme-Low (မူလတန်ဖိုး) နှင့် Low တို့အတွက်သာ ကန့်သတ်ထားပြီး မက်ရှ်ရွေးချယ်စရာများသည် မျက်နှာပြင် 20K အထိ ရှိသည်။ Material ၏ မူလတန်ဖိုးမှာ Shaded ဖြစ်သည်။ ထွက်ရလဒ်ဖော်မတ်များမှာ glb၊ usdz၊ fbx၊ obj သို့မဟုတ် stl ဖြစ်သည်။

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

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

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
image_urlsရွေးချယ်နိုင်သည် images
အမျိုးအစားurl[] · image
အကြောင်းအရာ ၅ ခုထက် မပိုပါ
မော်ဒယ်ဖန်တီးရန် အသုံးပြုသည့် မူရင်းပုံ 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 သည် `quality_mesh_option` ကို မည်သို့သတ်မှတ်ထားသည်ဖြစ်စေ အနိမ့်ဆုံးမုဒ်နှင့် တြိဂံ 50K ပါသော mesh ကို မဖြစ်မနေ အသုံးပြုသည်။ အဆင့်အသေးစိတ်ကို [Hyper3D စာရွက်စာတမ်းများ](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) တွင် ကြည့်ရှုနိုင်သည်။
promptရွေးချယ်နိုင်သည်
အမျိုးအစားstring
မူလတန်ဖိုး
စာလုံး ၁,၀၂၄ လုံးထက် မပိုပါ
စာသားဖြင့် ဖန်တီးမှုကို လမ်းညွှန်ပါ၊ သို့မဟုတ် Image-to-3D မုဒ်တွင် ဤနေရာကို ဗလာထားခြင်းဖြင့် ပုံများမှ ပရောမ့်ကို မော်ဒယ်က အလိုအလျောက် ရယူစေပါ။
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
မူလတန်ဖိုးShaded
PBRShadedAllNone
ပစ္စည်းထွက်ရလဒ် ရွေးချယ်မှု။ Texture မပါသော ဂျီဩမေတြီအတွက် None ကို ရွေးပါ၊ ပစ္စည်းအမျိုးအစားနှစ်မျိုးလုံး ရရှိရန် All ကို ရွေးပါ။ Physically based ပစ္စည်းများဖြင့် လက်တွေ့ဆန်သော အလင်းရောင်အတွက် PBR၊ PBR maps မပါသော baked lighting အတွက် Shaded ကို ရွေးပါ။
quality_mesh_optionရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Mesh topology နှင့်အတူ အရည်အသွေးကို ရွေးချယ်ပါ။ Quad သည် ချောမွေ့သော မျက်နှာပြင်များကို ဦးစားပေးပြီး Triangle သည် ဂျီဩမေတြီအသေးစိတ်ကို ဦးစားပေးသည်။ fast Endpoint သည် စမ်းသပ်ခြင်းနှင့် prototype ပြုလုပ်ခြင်းအတွက် အဓိကရည်ရွယ်ပြီး 20K ကန့်သတ်ချက်ရှိသည်။ အရည်အသွေးမြင့် mesh များအတွက် standard Endpoint ကို အသုံးပြုပါ။ ထိုနေရာတွင် Minimum၊ Extreme-Low နှင့် Low သည် 1M Triangle အထိ ပံ့ပိုးပြီး ရရှိနိုင်သော face အရေအတွက်မှာ အဆင့်အလိုက် ကွဲပြားသည်။ Hyper3D API တွင် `quality_override` သည် face အရေအတွက်ကို သတ်မှတ်ပြီး `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
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 ကန့်သတ်ချက်အလျား။
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/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.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/fast.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt