Ruka hadi kwenye maudhui

Hunyuan 3D Pro Image to 3D

Unganisha

Kitambulisho cha modeli hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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"

Faili kama mfano: $ 0.375 salio za API 375 · ≈ ₽ 40.30 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Tencent Picha hadi 3D #3d#hunyuan#image-to-3d

Huunda modeli ya 3D kutoka picha ya mbele pamoja na mitazamo ya ziada ya hiari, ikiwa na udhibiti wa idadi ya nyuso na PBR

Tencent · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika
Dondosha faili, au

URL ya picha ya JPG, PNG au WEBP ya mwonekano wa mbele, yenye mwonekano kutoka 128 hadi 5000px na ukubwa usiozidi 8 MB. Pendelea mandharinyuma rahisi na kitu kimoja kinachojaza zaidi ya 50% ya fremu.

Dondosha faili, au

URL ya picha ya mwonekano wa nyuma, ya hiari; JPG/PNG inapendekezwa.

Dondosha faili, au

URL ya picha ya mwonekano wa kushoto, ya hiari; JPG/PNG inapendekezwa.

Dondosha faili, au

URL ya picha ya mwonekano wa kulia, ya hiari; JPG/PNG inapendekezwa.

Dondosha faili, au

URL ya picha ya mwonekano wa juu, ya hiari na inayopatikana tu katika v3.1; JPG/PNG inapendekezwa.

Dondosha faili, au

URL ya picha ya hiari ya mwonekano wa chini, inayotumika tu katika v3.1. JPG/PNG inapendekezwa.

Dondosha faili, au

URL ya picha ya hiari inayopatikana tu katika v3.1, ikiwezekana katika umbizo la JPG/PNG. Picha hutoa mwonekano wa digrii 45 kutoka mbele kushoto.

Dondosha faili, au

URL ya picha ya hiari inayopatikana tu katika v3.1, ikiwezekana katika umbizo la JPG/PNG. Picha hutoa mwonekano wa digrii 45 kutoka mbele kulia.

chaguomsingi 500000

Idadi inayotakiwa ya nyuso za poligoni, kutoka 40,000 hadi 1,500,000. Chaguomsingi ni 500,000.

Ya kina generate_type
generate_type chaguomsingi Normal

Chagua kati ya modeli yenye texture iliyo na Normal na modeli nyeupe isiyo na texture, ya jiometri pekee, iliyo na Geometry. Katika v3.1, LowPoly/Sketch haiwezi kuchaguliwa.

POST /run/hunyuan-3d/v3.1/pro/image-to-3d?wait=20 makadirio → $ 0.375
# 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/hunyuan-3d/v3.1/pro/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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"

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Hunyuan 3D Pro Image to 3D

Huunda modeli ya 3D kutoka kwenye picha ya mbele inayohitajika, `input_image_url`. Mitazamo ya hiari ya nyuma, kushoto, kulia, juu, chini na miwili ya nyuzi 45 inaweza kuongeza maelezo. `generate_type` huchagua modeli yenye tekstura au ya jiometri nyeupe pekee, `enable_pbr` huongeza nyenzo za PBR, na `face_count` huanzia 40,000 hadi 1,500,000. Hurudisha GLB, URL za miundo mingine na kijipicha.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
input_image_urlinahitajika
Ainaurl · image
URL ya picha ya JPG, PNG au WEBP ya mwonekano wa mbele, yenye mwonekano kutoka 128 hadi 5000px na ukubwa usiozidi 8 MB. Pendelea mandharinyuma rahisi na kitu kimoja kinachojaza zaidi ya 50% ya fremu.
back_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa nyuma, ya hiari; JPG/PNG inapendekezwa.
left_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa kushoto, ya hiari; JPG/PNG inapendekezwa.
right_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa kulia, ya hiari; JPG/PNG inapendekezwa.
top_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa juu, ya hiari na inayopatikana tu katika v3.1; JPG/PNG inapendekezwa.
bottom_image_urlsi lazima
Ainaurl · image
URL ya picha ya hiari ya mwonekano wa chini, inayotumika tu katika v3.1. JPG/PNG inapendekezwa.
left_front_image_urlsi lazima
Ainaurl · image
URL ya picha ya hiari inayopatikana tu katika v3.1, ikiwezekana katika umbizo la JPG/PNG. Picha hutoa mwonekano wa digrii 45 kutoka mbele kushoto.
right_front_image_urlsi lazima
Ainaurl · image
URL ya picha ya hiari inayopatikana tu katika v3.1, ikiwezekana katika umbizo la JPG/PNG. Picha hutoa mwonekano wa digrii 45 kutoka mbele kulia.
generate_typesi lazima
Ainaenum
ChaguomsingiNormal
NormalGeometry
Chagua kati ya modeli yenye texture iliyo na Normal na modeli nyeupe isiyo na texture, ya jiometri pekee, iliyo na Geometry. Katika v3.1, LowPoly/Sketch haiwezi kuchaguliwa.
enable_pbrsi lazima
Ainaboolean
Chaguomsingifalse
Kigeuzi cha uzalishaji wa PBR, kisichotumika wakati generate_type ni Geometry. Vinginevyo, kukiwezesha huongeza texture za metallic, roughness na normal kwenye nyenzo zilizozalishwa.
face_countsi lazima
Ainainteger
Chaguomsingi500000
40,000 – 1,500,000
Idadi inayotakiwa ya nyuso za poligoni, kutoka 40,000 hadi 1,500,000. Chaguomsingi ni 500,000.
inahitajika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_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
    },
    "thumbnail": {
      "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
      },
      "obj": {
        "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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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
      },
      "usdz": {
        "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
  },
  "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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
model_glb
object {url, content_type, file_name, file_size}Faili la GLB lililo na kitu cha 3D kilichozalishwa.
thumbnail
object {url, content_type, file_name, file_size} | nullKijipicha kinachoonyesha onyesho la modeli iliyozalishwa.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Viungo vya modeli ya 3D katika miundo mbalimbali.
seed
integer | nullThamani ya mbegu inayotumika wakati wa uzalishaji.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/hunyuan-3d/v3.1/pro/image-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt