Bỏ qua đến nội dung

Hunyuan 3D Rapid Image to 3D

Tích hợp

Id mô hình hunyuan-3d/v3.1/rapid/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/rapid/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"

Yêu cầu này: 0,225 $ 225 tín dụng API · ≈ 24,18 ₽ Chạy trên trang này

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

Chuyển hình ảnh thành 3D nhanh, xây dựng mô hình từ một hình ảnh phía trước, với lưới PBR hoặc chưa có kết cấu tùy chọn

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

Cung cấp hình ảnh góc nhìn trước qua URL; nên dùng nền đơn giản với một đối tượng chiếm hơn 50% khung hình. Dùng JPG, PNG hoặc WEBP ở độ phân giải từ 128 đến 5000px, giới hạn tệp 8 MB; khi mã hóa base64, nên dùng 6 MB trở xuống.

Nâng cao enable_geometry
POST /run/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20 báo giá → 0,225 $
# 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/rapid/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 Rapid Image to 3D

Tạo mô hình 3D từ một hình ảnh phía trước (`input_image_url`, 128 đến 5000 px, tối đa 8MB, JPG, PNG hoặc WEBP). Hoạt động tốt nhất với nền đơn giản và một vật thể duy nhất chiếm hơn một nửa khung hình. `enable_pbr` thêm kết cấu kim loại, độ nhám và pháp tuyến, còn `enable_geometry` trả về mô hình màu trắng chưa có kết cấu dưới dạng GLB. Đầu ra gồm mô hình, URL theo từng định dạng, kết cấu, tệp MTL 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
Cung cấp hình ảnh góc nhìn trước qua URL; nên dùng nền đơn giản với một đối tượng chiếm hơn 50% khung hình. Dùng JPG, PNG hoặc WEBP ở độ phân giải từ 128 đến 5000px, giới hạn tệp 8 MB; khi mã hóa base64, nên dùng 6 MB trở xuống.
enable_pbrtùy chọn
Kiểuboolean
Mặc địnhfalse
Nút tạo PBR, không hoạt động khi enable_geometry là True. 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.
enable_geometrytùy chọn
Kiểuboolean
Mặc địnhfalse
Nút tạo chỉ có hình học, tắt hỗ trợ OBJ, đặt đầu ra mặc định thành GLB và bỏ qua enable_pbr khi được bật. Mô hình kết quả có màu trắng và không có kết cấu.
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/rapid/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": 225,
    "usd": "0.225",
    "charged": 225,
    "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
    },
    "material_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
    },
    "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
      }
    }
  },
  "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} | nullTệp chứa mô hình 3D được tạo, dùng GLB khi có và OBJ trong các trường hợp khác.
material_mtl
object {url, content_type, file_name, file_size} | nullTệp MTL chứa vật liệu cho mô hình OBJ.
texture
object {url, content_type, file_name, file_size} | nullHình ảnh cung cấp kết cấu của mô hình 3D.
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.

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/rapid/image-to-3d.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt