ਸਮੱਗਰੀ ਵੱਲ ਜਾਓ

Hunyuan3d V3 · Text to 3D

ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ

ਮਾਡਲ id 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ਉਦਾਹਰਨ ਵਰਗੀਆਂ ਫ਼ਾਈਲਾਂ: $0.375 375 API ਕ੍ਰੈਡਿਟ ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ ਚਲਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਮਾਪੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ

Normal, LowPoly ਜਾਂ Geometry ਆਉਟਪੁੱਟ ਅਤੇ PBR ਵਿਕਲਪ ਵਾਲਾ Hunyuan3D V3 text-to-3D

Tencent · 3D

ਤੁਹਾਡਾ ਪਹਿਲਾ ਨਤੀਜਾ ਇੱਥੇ ਹੋਵੇਗਾ

ਹੇਠਾਂ ਬੇਨਤੀ ਬਣਾਓ ਅਤੇ ਆਪਣੀ API ਕੁੰਜੀ ਨਾਲ ਚਲਾਓ। ਆਉਟਪੁੱਟ ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਕਾਪੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਹਮੇਸ਼ਾ ਲਈ ਜਾਂ ਮੁਫ਼ਤ ਵਿੱਚ 7 ਦਿਨ ਤੱਕ ਰੱਖੇ ਜਾਂਦੇ ਹਨ।

ਰਿਕਵੈਸਟ ਬਣਾਓ

ਕੰਟਰੋਲ ਮਾਡਲ ਸਕੀਮਾ ਤੋਂ ਤਿਆਰ ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਬਦਲਾਅ ਕਰਦੇ ਹੀ ਕੋਡ ਅਤੇ ਕੀਮਤ ਅੱਪਡੇਟ ਹੋ ਜਾਂਦੇ ਹਨ।

•ਲੋੜੀਂਦਾ 88 / 1024

1024 UTF-8 ਅੱਖਰਾਂ ਤੱਕ ਦਾ ਸਿਰਜਣਾ ਪ੍ਰੌਂਪਟ, ਜੋ ਦੱਸਦਾ ਹੈ ਕਿ ਕਿਹੜੀ 3D ਸਮੱਗਰੀ ਬਣਾਉਣੀ ਹੈ।

generate_type ਡਿਫ਼ਾਲਟ Normal

ਸਿਰਜਣਾ ਮੋਡ: `Normal` ਟੈਕਸਚਰਯੁਕਤ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ; `LowPoly` ਪੌਲੀਗਨ ਘਟਾਉਂਦਾ ਹੈ; `Geometry` ਬਿਨਾਂ ਟੈਕਸਚਰ ਵਾਲਾ ਸਫ਼ੈਦ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ।

ਡਿਫ਼ਾਲਟ 500000

ਫੇਸਾਂ ਦੀ ਇੱਛਿਤ ਗਿਣਤੀ, 40,000 ਤੋਂ 1,500,000 ਤੱਕ।

ਉੱਨਤ polygon_type · enable_safety_checker
polygon_type ਡਿਫ਼ਾਲਟ triangle

ਪੌਲੀਗਨ ਦੀ ਕਿਸਮ, ਸਿਰਫ਼ ਤਾਂ ਲਾਗੂ ਹੁੰਦੀ ਹੈ ਜੇ `GenerateType` `LowPoly` ਹੋਵੇ।

POST /run/hunyuan3d-v3/text-to-3d?wait=20 ਕੋਟ → $0.375
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ਇਹ ਬੇਨਤੀ ਚਲਾਓ

ਤੁਹਾਡੀ key ਇਸ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਰਹਿੰਦੀ ਹੈ: ਇਹ ਸਿਰਫ਼ Doitong API ਨੂੰ ਭੇਜੀ ਜਾਂਦੀ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਤਾਂ ਹੀ (localStorage) ਵਿੱਚ ਸੁਰੱਖਿਅਤ ਹੁੰਦੀ ਹੈ ਜੇ ਤੁਸੀਂ Remember ਚੁਣੋ। API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

Hunyuan3d V3 · Text to 3D ਬਾਰੇ

ਵੱਧ ਤੋਂ ਵੱਧ 1024 ਅੱਖਰਾਂ ਦੇ `prompt` ਤੋਂ 3D ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ, ਚਿੱਤਰ ਦੀ ਲੋੜ ਨਹੀਂ। `generate_type` ਟੈਕਸਚਰ ਵਾਲਾ Normal ਮਾਡਲ, LowPoly ਰਿਡਕਸ਼ਨ ਜਾਂ ਸਫ਼ੈਦ Geometry ਮਾਡਲ ਚੁਣਦਾ ਹੈ; `polygon_type` LowPoly ਲਈ triangle ਜਾਂ quadrilateral ਸੈੱਟ ਕਰਦਾ ਹੈ। `enable_pbr` PBR ਮਟੀਰੀਅਲ ਜੋੜਦਾ ਹੈ ਅਤੇ `face_count` 40000 ਤੋਂ 1500000 ਤੱਕ ਹੁੰਦਾ ਹੈ।

ਪੈਰਾਮੀਟਰ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
promptਲੋੜੀਂਦਾ
ਕਿਸਮstring
≤ 1,024 ਅੱਖਰ
1024 UTF-8 ਅੱਖਰਾਂ ਤੱਕ ਦਾ ਸਿਰਜਣਾ ਪ੍ਰੌਂਪਟ, ਜੋ ਦੱਸਦਾ ਹੈ ਕਿ ਕਿਹੜੀ 3D ਸਮੱਗਰੀ ਬਣਾਉਣੀ ਹੈ।
enable_safety_checkerਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟtrue
false ਸੈੱਟ ਕਰਕੇ ਸਕ੍ਰੀਨਿੰਗ ਨੂੰ ਢਿੱਲਾ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ, ਜੇ ਕਾਲਰ ਅਧਿਕਾਰਤ ਹੋਵੇ।
enable_pbrਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟfalse
PBR ਮਟੀਰੀਅਲ ਸਿਰਜਣ ਲਈ ਟੌਗਲ।
face_countਵਿਕਲਪਿਕ
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ500000
40,000 – 15,00,000
ਫੇਸਾਂ ਦੀ ਇੱਛਿਤ ਗਿਣਤੀ, 40,000 ਤੋਂ 1,500,000 ਤੱਕ।
generate_typeਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟNormal
NormalLowPolyGeometry
ਸਿਰਜਣਾ ਮੋਡ: `Normal` ਟੈਕਸਚਰਯੁਕਤ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ; `LowPoly` ਪੌਲੀਗਨ ਘਟਾਉਂਦਾ ਹੈ; `Geometry` ਬਿਨਾਂ ਟੈਕਸਚਰ ਵਾਲਾ ਸਫ਼ੈਦ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ।
polygon_typeਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟtriangle
trianglequadrilateral
ਪੌਲੀਗਨ ਦੀ ਕਿਸਮ, ਸਿਰਫ਼ ਤਾਂ ਲਾਗੂ ਹੁੰਦੀ ਹੈ ਜੇ `GenerateType` `LowPoly` ਹੋਵੇ।
ਲੋੜੀਂਦਾ

ਆਉਟਪੁੱਟ

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡੀ ਚੋਣਹਰ outputs[].url ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਇੱਕ ਕਾਪੀ ਹੈ: ਹਮੇਸ਼ਾ ਲਈ ਰੱਖੀ ਜਾਂਦੀ ਹੈ (ਪ੍ਰਤੀ GB-ਮਹੀਨਾ ਭੁਗਤਾਨ) ਜਾਂ 7 ਦਿਨ ਤੱਕ ਮੁਫ਼ਤ, ਤੁਹਾਡੀ ਖਾਤਾ ਸੈਟਿੰਗ ਜਾਂ ?storage= ਅਨੁਸਾਰ।
ਹਰ ਮਾਡਲ ’ਤੇ ਇੱਕੋ ਜਿਹਾ ਰੂਪਤਸਵੀਰਾਂ, ਵੀਡੀਓ ਅਤੇ ਆਡੀਓ ਸਭ ਲਈ type, url, content_type, width, height ਅਤੇ duration। output ਮਾਡਲ ਦਾ ਆਪਣਾ ਨਤੀਜਾ ਆਬਜੈਕਟ ਹੈ।
ਆਉਟਪੁੱਟ ਦੇ ਫ਼ੀਲਡ
model_glb
object {url, content_type, file_name, file_size}ਸਿਰਜੀ ਗਈ 3D ਵਸਤੂ ਵਾਲੀ GLB ਫ਼ਾਈਲ।
thumbnail
object {url, content_type, file_name, file_size} | nullਸਿਰਜੇ ਗਏ ਮਾਡਲ ਦੀ ਝਲਕ ਦਿਖਾਉਣ ਵਾਲਾ ਥੰਬਨੇਲ।
model_urls
object {glb, fbx, obj, usdz}ਵੱਖ-ਵੱਖ ਫਾਰਮੈਟਾਂ ਵਿੱਚ 3D ਮਾਡਲ ਦੇ ਲਿੰਕ।
seed
integer | nullਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਗਿਆ seed ਮੁੱਲ।

ਹੋਰ ਮਾਡਲ: ਟੈਕਸਟ ਤੋਂ 3D

AI ਏਜੰਟਾਂ ਲਈ: ਇਹ ਪੰਨਾ Markdown ਵਜੋਂ ਇੱਥੇ ਹੈ https://doitong.com/pa/developers/models/hunyuan3d-v3/text-to-3d.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt