Ruka hadi kwenye maudhui

Hunyuan3d V3 · Image to 3D

Unganisha

Kitambulisho cha modeli hunyuan3d-v3/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/hunyuan3d-v3/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.24 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Tencent Picha hadi 3D

Hunyuan3D V3 kutoka picha hadi 3D ikiwa na mitazamo ya nyuma/kushoto/kulia, PBR na hali ya low-poly kwa hiari

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 inayotumika kwa uzalishaji wa modeli ya 3D.

Dondosha faili, au

URL ya picha ya mwonekano wa nyuma, inayotolewa kwa hiari ili kuboresha uundaji upya wa 3D.

Dondosha faili, au

URL ya picha ya mwonekano wa kushoto, inayotolewa kwa hiari ili kuboresha uundaji upya wa 3D.

Dondosha faili, au

URL ya picha ya mwonekano wa kulia, inayotolewa kwa hiari ili kuboresha uundaji upya wa 3D.

generate_type chaguomsingi Normal

Hali ya uzalishaji: `Normal` huzalisha modeli yenye maandishi; `LowPoly` hupunguza poligoni; `Geometry` huzalisha modeli nyeupe isiyo na maandishi.

chaguomsingi 500000

Idadi inayotarajiwa ya nyuso, kuanzia 40,000 hadi 1,500,000.

Ya kina polygon_type · enable_safety_checker
polygon_type chaguomsingi triangle

Aina ya poligoni, inayotumika tu ikiwa `GenerateType` ni `LowPoly`.

POST /run/hunyuan3d-v3/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/hunyuan3d-v3/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 Hunyuan3d V3 · Image to 3D

Huunda modeli ya 3D kutoka `input_image_url`, ikiwa na `back_image_url`, `left_image_url` na `right_image_url` za hiari ili kuboresha ujenzi upya. `generate_type` huchagua Normal, LowPoly au Geometry (isiyo na tekstura), na `polygon_type` huchagua pembetatu au pembe nne kwa LowPoly. `enable_pbr` huongeza nyenzo za PBR na `face_count` huwa kati ya 40000 na 1500000. Hurejesha GLB, URL za miundo mingine na kijipicha.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
input_image_urlinahitajika
Ainaurl · image
URL ya picha inayotumika kwa uzalishaji wa modeli ya 3D.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.
back_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa nyuma, inayotolewa kwa hiari ili kuboresha uundaji upya wa 3D.
left_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa kushoto, inayotolewa kwa hiari ili kuboresha uundaji upya wa 3D.
right_image_urlsi lazima
Ainaurl · image
URL ya picha ya mwonekano wa kulia, inayotolewa kwa hiari ili kuboresha uundaji upya wa 3D.
enable_pbrsi lazima
Ainaboolean
Chaguomsingifalse
Zalisha nyenzo za PBR isipokuwa generate_type ni Geometry; katika hali hiyo, mpangilio huu hauna athari.
face_countsi lazima
Ainainteger
Chaguomsingi500000
40,000 – 1,500,000
Idadi inayotarajiwa ya nyuso, kuanzia 40,000 hadi 1,500,000.
generate_typesi lazima
Ainaenum
ChaguomsingiNormal
NormalLowPolyGeometry
Hali ya uzalishaji: `Normal` huzalisha modeli yenye maandishi; `LowPoly` hupunguza poligoni; `Geometry` huzalisha modeli nyeupe isiyo na maandishi.
polygon_typesi lazima
Ainaenum
Chaguomsingitriangle
trianglequadrilateral
Aina ya poligoni, inayotumika tu ikiwa `GenerateType` ni `LowPoly`.
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": "hunyuan3d-v3/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
      },
      "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, 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/hunyuan3d-v3/image-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt