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

Tripo H3.1 Image to 3D

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

မော်ဒယ် id tripo3d/h3.1/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/tripo3d/h3.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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"

နမူနာကဲ့သို့ ဖိုင်များ: ၀.၃၀ $ ၃၀၀ API ခရက်ဒစ် · ≈ ၃၂.၂၇ ₽ လုပ်ဆောင်မီ သင့်ဖိုင်များကို တိုင်းတာသည် ဤစာမျက်နှာတွင် လုပ်ဆောင်ရန်

API ကီး ရယူရန်
Tripo ပုံမှ 3D #3d#image-to-3d#3d-generation#tripo

PBR material များ၊ လေးမျက်နှာ မက်ရှ်များနှင့် မျက်နှာအရေအတွက် ထိန်းချုပ်မှုပါသည့် ပုံတစ်ပုံမှ 3D ဖန်တီးမှု

Tripo · 3D

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

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

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

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

•လိုအပ်သည် image_url
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

3D မော်ဒယ် ဖန်တီးရန် အသုံးပြုသော input-image URL။

texture_quality မူလ standard

Texture အရည်အသွေးဆက်တင်။ 'detailed' ကို ရွေးချယ်ပါက texture ရုပ်ထွက်အရည်အသွေး မြင့်တက်သည်။

geometry_quality မူလ standard

Geometry အတွက် အရည်အသွေးဆက်တင်။

အဆင့်မြင့် texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment မူလ original_image

Texture alignment ရည်ညွှန်းချက်: ဖန်တီးထားသော geometry အတွက် 'geometry' သို့မဟုတ် ထည့်သွင်းချက် ပုံ အတွက် 'original_image' ကို အသုံးပြုပါ။

orientation မူလ default

မော်ဒယ်၏ ဦးတည်ချက်။ 'align_image' သည် ထည့်သွင်းချက် ပုံ နှင့် ကိုက်ညီစေရန် အလိုအလျောက် လှည့်ပေးသည်။

Mesh ဖန်တီးမှုအတွက် သတ်မှတ်ထားသော face အရေအတွက် ရည်မှန်းချက်။ ပေးထားပါက မော်ဒယ်၏ adaptive count ရွေးချယ်မှုကို အစားထိုးသည်။

Geometry ဖန်တီးမှုကို ထပ်တူပြန်လည်ရရှိနိုင်စေရန် အသုံးပြုသော seed။

Texture ဖန်တီးမှုကို ထပ်တူပြန်လည်ရရှိနိုင်စေရန် အသုံးပြုသော seed။

POST /run/tripo3d/h3.1/image-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/tripo3d/h3.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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"

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

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

Tripo H3.1 Image to 3D အကြောင်း

`image_url` ရှိ ပုံတစ်ပုံမှ 3D မော်ဒယ်ကို ဖန်တီးသည်။ ရွေးချယ်စရာများတွင် `face_limit` (1,000 မှ 2,000,000)၊ `texture`၊ `pbr`၊ စံ သို့မဟုတ် အသေးစိတ် `texture_quality` နှင့် `geometry_quality`၊ `quad` ဖွဲ့စည်းပုံ၊ `auto_size` နှင့် `orientation` တို့ ပါဝင်သည်။ ရလဒ်တွင် အကြိုကြည့်ရှုရန် ပုံဖော်ခြင်းနှင့် နောက်ပိုင်း ရစ်ဂင်းအတွက် လုပ်ငန်း ID ပါဝင်သည်။

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

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

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
image_urlလိုအပ်သည် image
အမျိုးအစားurl · image
3D မော်ဒယ် ဖန်တီးရန် အသုံးပြုသော input-image URL။
face_limitရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
၁,၀၀၀ – ၂,၀၀၀,၀၀၀
Mesh ဖန်တီးမှုအတွက် သတ်မှတ်ထားသော face အရေအတွက် ရည်မှန်းချက်။ ပေးထားပါက မော်ဒယ်၏ adaptive count ရွေးချယ်မှုကို အစားထိုးသည်။
textureရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
မော်ဒယ်က ဖန်တီးထားသော texture များကို ရရှိမရ ထိန်းချုပ်သည်။
pbrရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
PBR materials (Physically Based Rendering) ကို ဖွင့်သည်။ true ဖြစ်ပါက texture ဖန်တီးမှုကိုလည်း ဖွင့်သည်။
model_seedရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
Geometry ဖန်တီးမှုကို ထပ်တူပြန်လည်ရရှိနိုင်စေရန် အသုံးပြုသော seed။
texture_seedရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
Texture ဖန်တီးမှုကို ထပ်တူပြန်လည်ရရှိနိုင်စေရန် အသုံးပြုသော seed။
texture_qualityရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးstandard
standarddetailed
Texture အရည်အသွေးဆက်တင်။ 'detailed' ကို ရွေးချယ်ပါက texture ရုပ်ထွက်အရည်အသွေး မြင့်တက်သည်။
geometry_qualityရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးstandard
standarddetailed
Geometry အတွက် အရည်အသွေးဆက်တင်။
texture_alignmentရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးoriginal_image
original_imagegeometry
Texture alignment ရည်ညွှန်းချက်: ဖန်တီးထားသော geometry အတွက် 'geometry' သို့မဟုတ် ထည့်သွင်းချက် ပုံ အတွက် 'original_image' ကို အသုံးပြုပါ။
auto_sizeရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
မော်ဒယ်ကို မီတာဖြင့် တိုင်းတာထားသော လက်တွေ့ကမ္ဘာအရွယ်အစားအတိုင်း ဖြစ်စေရန် အလိုအလျောက် scale ပြုလုပ်ခြင်း။
orientationရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးdefault
defaultalign_image
မော်ဒယ်၏ ဦးတည်ချက်။ 'align_image' သည် ထည့်သွင်းချက် ပုံ နှင့် ကိုက်ညီစေရန် အလိုအလျောက် လှည့်ပေးသည်။
quadရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးfalse
Quad topology ကို ဖွင့်ခြင်းဖြင့် တြိဂံမျက်နှာပြင်များနှင့် ဘက် 4 ဘက်ရှိ quads တို့အကြား ရွေးချယ်ပါ။ Quad ရလဒ်အတွက် Tripo က data ကို FBX bytes အဖြစ် ပေးပါက FBX ဖိုင်ကို ပြန်ပေးသည်။
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": "tripo3d/h3.1/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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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_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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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 မော်ဒယ်ပါဝင်သည့် GLB သို့မဟုတ် FBX ဖိုင်။ ဖော်မတ်သည် Tripo ထုတ်ပေးသည့်အရာအပေါ် မူတည်သည်။
model_urls
object {glb, fbx, base_model, pbr_model}3D မော်ဒယ်၏ အခြားဗားရှင်းများသို့ ညွှန်ပြသော URL များ။
rendered_image
object {url, content_type, file_name, file_size} | nullဖန်တီးထားသော 3D မော်ဒယ်ကို ပြသသည့် render preview။
task_id
string | nullဖန်တီးထားသော မော်ဒယ်ကို သတ်မှတ်ပေးသည့် ပြန်လည်အသုံးပြုနိုင်သော Tripo task ID။ ထိုကြောင့် မော်ဒယ်ကို ထပ်မံ upload မပြုဘဲ rig သို့မဟုတ် rig-check လုပ်ဆောင်ချက်များကို အသုံးပြုနိုင်သည်။

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

AI အေးဂျင့်များအတွက်- ဤစာမျက်နှာ၏ Markdown ကို ဤနေရာတွင် ရရှိနိုင်သည် https://doitong.com/my/developers/models/tripo3d/h3.1/image-to-3d.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt