Bỏ qua đến nội dung

Hunyuan 3D Pro Image to 3D

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 0,375 $ 375 tín dụng API · ≈ 40,24 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Tencent Hình ảnh sang 3D #3d#hunyuan#image-to-3d

Tạo mô hình 3D từ ảnh chính diện và các góc nhìn bổ sung tùy chọn, có điều khiển số mặt và PBR

Tencent · 3D

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc
Thả tệp hoặc

URL hình ảnh JPG, PNG hoặc WEBP góc nhìn trước, với độ phân giải từ 128 đến 5000px và kích thước không quá 8 MB. Nên dùng nền đơn giản và một đối tượng chiếm hơn 50% khung hình.

Thả tệp hoặc

URL hình ảnh góc nhìn sau, tùy chọn; khuyến nghị JPG/PNG.

Thả tệp hoặc

URL hình ảnh góc nhìn bên trái, tùy chọn; khuyến nghị JPG/PNG.

Thả tệp hoặc

URL hình ảnh góc nhìn bên phải, tùy chọn; khuyến nghị JPG/PNG.

Thả tệp hoặc

URL hình ảnh góc nhìn trên, tùy chọn và chỉ khả dụng trong v3.1; khuyến nghị JPG/PNG.

Thả tệp hoặc

URL hình ảnh góc nhìn dưới tùy chọn, chỉ được hỗ trợ trong v3.1. Khuyến nghị JPG/PNG.

Thả tệp hoặc

URL hình ảnh tùy chọn chỉ khả dụng trong v3.1, ưu tiên định dạng JPG/PNG. Hình ảnh cung cấp góc nhìn 45 độ từ phía trước bên trái.

Thả tệp hoặc

URL hình ảnh tùy chọn chỉ khả dụng trong v3.1, ưu tiên định dạng JPG/PNG. Hình ảnh cung cấp góc nhìn 45 độ từ phía trước bên phải.

mặc định 500000

Số mặt đa giác mong muốn, từ 40,000 đến 1,500,000. Mặc định là 500,000.

Nâng cao generate_type
generate_type mặc định Normal

Chọn giữa mô hình có kết cấu với Normal và mô hình trắng chỉ có hình học, không kết cấu với Geometry. Trong v3.1, không thể chọn LowPoly/Sketch.

POST /run/hunyuan-3d/v3.1/pro/image-to-3d?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Hunyuan 3D Pro Image to 3D

Tạo mô hình 3D từ hình ảnh phía trước bắt buộc, `input_image_url`. Có thể thêm chi tiết bằng các góc nhìn sau, trái, phải, trên, dưới và hai góc 45 độ tùy chọn. `generate_type` chọn mô hình có kết cấu hoặc mô hình chỉ có hình học màu trắng, `enable_pbr` thêm vật liệu PBR, còn `face_count` nằm trong khoảng 40,000 đến 1,500,000. Trả về GLB, URL của các định dạng khác và hình thu nhỏ.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
input_image_urlbắt buộc
Kiểuurl · image
URL hình ảnh JPG, PNG hoặc WEBP góc nhìn trước, với độ phân giải từ 128 đến 5000px và kích thước không quá 8 MB. Nên dùng nền đơn giản và một đối tượng chiếm hơn 50% khung hình.
back_image_urltùy chọn
Kiểuurl · image
URL hình ảnh góc nhìn sau, tùy chọn; khuyến nghị JPG/PNG.
left_image_urltùy chọn
Kiểuurl · image
URL hình ảnh góc nhìn bên trái, tùy chọn; khuyến nghị JPG/PNG.
right_image_urltùy chọn
Kiểuurl · image
URL hình ảnh góc nhìn bên phải, tùy chọn; khuyến nghị JPG/PNG.
top_image_urltùy chọn
Kiểuurl · image
URL hình ảnh góc nhìn trên, tùy chọn và chỉ khả dụng trong v3.1; khuyến nghị JPG/PNG.
bottom_image_urltùy chọn
Kiểuurl · image
URL hình ảnh góc nhìn dưới tùy chọn, chỉ được hỗ trợ trong v3.1. Khuyến nghị JPG/PNG.
left_front_image_urltùy chọn
Kiểuurl · image
URL hình ảnh tùy chọn chỉ khả dụng trong v3.1, ưu tiên định dạng JPG/PNG. Hình ảnh cung cấp góc nhìn 45 độ từ phía trước bên trái.
right_front_image_urltùy chọn
Kiểuurl · image
URL hình ảnh tùy chọn chỉ khả dụng trong v3.1, ưu tiên định dạng JPG/PNG. Hình ảnh cung cấp góc nhìn 45 độ từ phía trước bên phải.
generate_typetùy chọn
Kiểuenum
Mặc địnhNormal
NormalGeometry
Chọn giữa mô hình có kết cấu với Normal và mô hình trắng chỉ có hình học, không kết cấu với Geometry. Trong v3.1, không thể chọn LowPoly/Sketch.
enable_pbrtùy chọn
Kiểuboolean
Mặc địnhfalse
Nút tạo PBR, không hoạt động khi generate_type là Geometry. Nếu không, bật tùy chọn này sẽ thêm kết cấu metallic, roughness và normal vào vật liệu được tạo.
face_counttùy chọn
Kiểuinteger
Mặc định500000
40.000 – 1.500.000
Số mặt đa giác mong muốn, từ 40,000 đến 1,500,000. Mặc định là 500,000.
bắt buộc

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
model_glb
object {url, content_type, file_name, file_size}Tệp GLB chứa đối tượng 3D được tạo.
thumbnail
object {url, content_type, file_name, file_size} | nullHình thu nhỏ hiển thị bản xem trước của mô hình được tạo.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Liên kết đến mô hình 3D ở nhiều định dạng.
seed
integer | nullGiá trị seed dùng trong quá trình tạo sinh.

Thêm mô hình: Hình ảnh sang 3D

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/hunyuan-3d/v3.1/pro/image-to-3d.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt