Bỏ qua đến nội dung

Hunyuan3d V3 · Image to 3D

Tích hợp

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

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 · 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 dùng để tạo sinh mô hình 3D.

Thả tệp hoặc

URL hình ảnh mặt sau, tùy chọn, dùng để cải thiện quá trình tái dựng 3D.

Thả tệp hoặc

URL hình ảnh mặt trái, tùy chọn, dùng để cải thiện quá trình tái dựng 3D.

Thả tệp hoặc

URL hình ảnh mặt phải, tùy chọn, dùng để cải thiện quá trình tái dựng 3D.

generate_type mặc định Normal

Chế độ tạo sinh: `Normal` tạo mô hình có kết cấu; `LowPoly` giảm số đa giác; `Geometry` tạo mô hình trắng không có kết cấu.

mặc định 500000

Số mặt mong muốn, trong khoảng từ 40,000 đến 1,500,000.

Nâng cao polygon_type · enable_safety_checker
polygon_type mặc định triangle

Loại đa giác, chỉ áp dụng khi `GenerateType` là `LowPoly`.

POST /run/hunyuan3d-v3/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/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"

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ề Hunyuan3d V3 · Image to 3D

Tạo mô hình 3D từ `input_image_url`, với tùy chọn `back_image_url`, `left_image_url` và `right_image_url` để cải thiện việc tái tạo. `generate_type` chọn Normal, LowPoly hoặc Geometry (không có kết cấu), còn `polygon_type` chọn tam giác hoặc tứ giác cho LowPoly. `enable_pbr` thêm vật liệu PBR và `face_count` nằm trong khoảng từ 40000 đến 1500000. Trả về GLB, URL của các định dạng khác và ả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 dùng để tạo sinh mô hình 3D.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyền.
back_image_urltùy chọn
Kiểuurl · image
URL hình ảnh mặt sau, tùy chọn, dùng để cải thiện quá trình tái dựng 3D.
left_image_urltùy chọn
Kiểuurl · image
URL hình ảnh mặt trái, tùy chọn, dùng để cải thiện quá trình tái dựng 3D.
right_image_urltùy chọn
Kiểuurl · image
URL hình ảnh mặt phải, tùy chọn, dùng để cải thiện quá trình tái dựng 3D.
enable_pbrtùy chọn
Kiểuboolean
Mặc địnhfalse
Tạo vật liệu PBR trừ khi generate_type là Geometry; trong trường hợp đó, thiết lập này không có hiệu lực.
face_counttùy chọn
Kiểuinteger
Mặc định500000
40.000 – 1.500.000
Số mặt mong muốn, trong khoảng từ 40,000 đến 1,500,000.
generate_typetùy chọn
Kiểuenum
Mặc địnhNormal
NormalLowPolyGeometry
Chế độ tạo sinh: `Normal` tạo mô hình có kết cấu; `LowPoly` giảm số đa giác; `Geometry` tạo mô hình trắng không có kết cấu.
polygon_typetùy chọn
Kiểuenum
Mặc địnhtriangle
trianglequadrilateral
Loại đa giác, chỉ áp dụng khi `GenerateType` là `LowPoly`.
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": "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"
  }
}
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, 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/hunyuan3d-v3/image-to-3d.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt