Ruka hadi kwenye maudhui

Hunyuan3d V3 · Text to 3D

Unganisha

Kitambulisho cha modeli hunyuan3d-v3/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/hunyuan3d-v3/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"

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

Hunyuan3D V3 kutoka maandishi hadi 3D yenye matokeo ya Normal, LowPoly au Geometry na chaguo la 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 88 / 1024

Kidokezo cha uzalishaji kinachoruhusu hadi herufi 1024 za UTF-8 kubainisha maudhui ya 3D ya kuunda.

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/text-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/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"

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 · Text to 3D

Huunda modeli ya 3D kutoka `prompt` yenye hadi herufi 1024, bila kuhitaji picha. `generate_type` huchagua modeli ya Normal yenye tekstura, upunguzaji wa LowPoly au modeli nyeupe ya Geometry; `polygon_type` huweka pembetatu au pembe nne kwa LowPoly. `enable_pbr` huongeza nyenzo za PBR na `face_count` huwa kati ya 40000 na 1500000.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
promptinahitajika
Ainastring
≤ herufi 1,024
Kidokezo cha uzalishaji kinachoruhusu hadi herufi 1024 za UTF-8 kubainisha maudhui ya 3D ya kuunda.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.
enable_pbrsi lazima
Ainaboolean
Chaguomsingifalse
Kigeuza cha kuzalisha nyenzo za PBR.
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

Tokeo

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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: Maandishi hadi 3D

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