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

Hyper3D - Rodin V2.5 - Text to 3D

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

မော်ဒယ် id hyper3d/rodin/v2.5/text-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/hyper3d/rodin/v2.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

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

API ကီး ရယူရန်
Hyper3D စာသားမှ 3D 4K ထွက်ရလဒ်မြန်ဆန် #text-to-3d

စာလုံး 1024 အထိရှိသော ပရောမ့်မှ အဆင့် 6 ခုဖြင့် Rodin V2.5 စာသားမှ 3D

Hyper3D · 3D

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

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

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

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

•လိုအပ်သည် 88 / 1024

မော်ဒယ်ဖန်တီးမှုကို လမ်းညွှန်သည့် စာသားညွှန်ကြားချက်များ။ Text-to-3D မုဒ်တွင် မဖြစ်မနေလိုအပ်သည်။

အဆင့်မြင့် geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
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 အသုံးပြု၍ ဖန်တီးမည့် မော်ဒယ်၏ အရွယ်အစားကို ကန့်သတ်ပါ။

လိုအပ်ပါက အသုံးပြုရန် ထပ်ဆောင်းရွေးချယ်စရာများ။

POST /run/hyper3d/rodin/v2.5/text-to-3d?wait=20 ကုန်ကျစရိတ် → ၀.၄၀ $
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

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

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

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

လိုအပ်သော အက္ခရာ 1024 အထိရှိ `prompt` မှ 3D မော်ဒယ်ကို ဖန်တီးပေးသည်။ Gen-2.5-Minimum မှ Gen-2.5-Extreme-High (မူလတန်ဖိုး High) အထိ `tier` တစ်ခု၊ လေးထောင့် သို့မဟုတ် တြိဂံ မက်ရှ်အရွယ်အစားတစ်ခုနှင့် PBR သို့မဟုတ် Shaded ကဲ့သို့သော `material` တစ်ခုကို ရွေးချယ်နိုင်သည်။ glb၊ usdz၊ fbx၊ obj သို့မဟုတ် stl အဖြစ် ထုတ်ယူနိုင်ပြီး `seed` ကို 0 နှင့် 65535 ကြား သတ်မှတ်နိုင်သည်။

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

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
promptလိုအပ်သည်
အမျိုးအစားstring
စာလုံး ၁,၀၂၄ လုံးထက် မပိုပါ
မော်ဒယ်ဖန်တီးမှုကို လမ်းညွှန်သည့် စာသားညွှန်ကြားချက်များ။ Text-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) တွင် ကြည့်ပါ။
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
လိုအပ်ပါက အသုံးပြုရန် ထပ်ဆောင်းရွေးချယ်စရာများ။
addons.high_packရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
HighPack မြှင့်တင်မှု။ Quad ထွက်ရလဒ်တွင် quality ပါရာမီတာမှ တောင်းဆိုထားသော face အရေအတွက်၏ ခန့်မှန်းခြေ 16 ဆ ပါဝင်ပြီး textures သည် မူလ 2K အစား 4K ရုပ်ထွက်အရည်အသွေးကို အသုံးပြုသည်။
enable_safety_checkerရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
caller က ခွင့်ပြုချက်ရှိပါက false သတ်မှတ်ခြင်းဖြင့် စစ်ဆေးမှုကို လျှော့ချနိုင်သည်။
လိုအပ်သည်

ထွက်ရလဒ်

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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-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/text-to-3d.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt