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

Hunyuan3d V3 · Sketch to 3D

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

ਮਾਡਲ id hunyuan3d-v3/sketch-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/sketch-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",
    "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"

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

API ਕੁੰਜੀ ਲਵੋ

Hunyuan3D V3, ਜੋ ਸਕੈਚ ਜਾਂ ਲਾਈਨ ਆਰਟ ਅਤੇ ਟੈਕਸਟ ਪ੍ਰੌਂਪਟ ਨੂੰ 3D ਮਾਡਲ ਵਿੱਚ ਬਦਲਦਾ ਹੈ

Tencent · 3D

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

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

ਰਿਕਵੈਸਟ ਬਣਾਓ

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

•ਲੋੜੀਂਦਾ 88 / 1024

3D ਸਮੱਗਰੀ ਲਈ ਟੈਕਸਟ ਪ੍ਰੌਂਪਟ ਵਿੱਚ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦਿਓ—ਜਿਵੇਂ ਇਸ ਦਾ ਮਟੀਰੀਅਲ, ਰੰਗ ਜਾਂ ਸ਼੍ਰੇਣੀ।

•ਲੋੜੀਂਦਾ
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

3D ਮਾਡਲ ਵਿੱਚ ਬਦਲਣ ਲਈ ਸਕੈਚ ਜਾਂ ਲਾਈਨ-ਆਰਟ ਚਿੱਤਰ ਦਾ URL। ਸਮਰਥਿਤ ਚਿੱਤਰ ਮਾਪ 128 × 128 ਤੋਂ 5000 × 5000 ਪਿਕਸਲ ਤੱਕ ਹਨ।

ਡਿਫ਼ਾਲਟ 500000

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

ਉੱਨਤ enable_safety_checker
POST /run/hunyuan3d-v3/sketch-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.ru/v1/run/hunyuan3d-v3/sketch-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",
    "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"

ਇਹ ਬੇਨਤੀ ਚਲਾਓ

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

Hunyuan3d V3 · Sketch to 3D ਬਾਰੇ

ਇਸ ਲਈ ਇੱਕ ਸਕੈਚ ਜਾਂ line-art ਚਿੱਤਰ (`input_image_url`, 128x128 ਤੋਂ 5000x5000 ਪਿਕਸਲ) ਅਤੇ ਰੰਗ, ਸ਼੍ਰੇਣੀ ਤੇ ਮਟੀਰੀਅਲ ਦਾ ਵੇਰਵਾ ਦੇਣ ਵਾਲਾ ਵੱਧ ਤੋਂ ਵੱਧ 1024 ਅੱਖਰਾਂ ਦਾ `prompt` ਲੋੜੀਂਦਾ ਹੈ। `enable_pbr` PBR ਮਟੀਰੀਅਲ ਚਾਲੂ ਕਰਦਾ ਹੈ, ਅਤੇ `face_count` ਟਾਰਗੇਟ ਪੌਲੀਗਨ ਗਿਣਤੀ 40000 ਤੋਂ 1500000 ਤੱਕ ਸੈੱਟ ਕਰਦਾ ਹੈ। ਇੱਕ GLB ਫ਼ਾਈਲ, ਹੋਰ ਫਾਰਮੈਟਾਂ ਦੇ URL ਅਤੇ ਥੰਬਨੇਲ ਵਾਪਸ ਕਰਦਾ ਹੈ।

ਪੈਰਾਮੀਟਰ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
input_image_urlਲੋੜੀਂਦਾ
ਕਿਸਮurl · image
3D ਮਾਡਲ ਵਿੱਚ ਬਦਲਣ ਲਈ ਸਕੈਚ ਜਾਂ ਲਾਈਨ-ਆਰਟ ਚਿੱਤਰ ਦਾ URL। ਸਮਰਥਿਤ ਚਿੱਤਰ ਮਾਪ 128 × 128 ਤੋਂ 5000 × 5000 ਪਿਕਸਲ ਤੱਕ ਹਨ।
enable_safety_checkerਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟtrue
false ਸੈੱਟ ਕਰਕੇ ਸਕ੍ਰੀਨਿੰਗ ਨੂੰ ਢਿੱਲਾ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ, ਜੇ ਕਾਲਰ ਅਧਿਕਾਰਤ ਹੋਵੇ।
promptਲੋੜੀਂਦਾ
ਕਿਸਮstring
≤ 1,024 ਅੱਖਰ
3D ਸਮੱਗਰੀ ਲਈ ਟੈਕਸਟ ਪ੍ਰੌਂਪਟ ਵਿੱਚ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦਿਓ—ਜਿਵੇਂ ਇਸ ਦਾ ਮਟੀਰੀਅਲ, ਰੰਗ ਜਾਂ ਸ਼੍ਰੇਣੀ।
enable_pbrਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟfalse
PBR ਮਟੀਰੀਅਲ ਸਿਰਜਣ ਲਈ ਟੌਗਲ।
face_countਵਿਕਲਪਿਕ
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ500000
40,000 – 15,00,000
ਫੇਸਾਂ ਦੀ ਇੱਛਿਤ ਗਿਣਤੀ, 40,000 ਤੋਂ 1,500,000 ਤੱਕ।
ਲੋੜੀਂਦਾ

ਫ਼ਾਈਲ ਪੈਰਾਮੀਟਰ ਜਨਤਕ https:// URL, 10 MB ਤੱਕ ਦਾ data: URI, ਜਾਂ ਅੱਪਲੋਡ ਦੇ file_url ਨੂੰ ਸਵੀਕਾਰਦੇ ਹਨ। ਫ਼ਾਈਲਾਂ

ਆਉਟਪੁੱਟ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/sketch-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",
    "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"
  }
}
ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡੀ ਚੋਣਹਰ 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/sketch-to-3d.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt