Bỏ qua đến nội dung

Hi3D Image to 3D

Tích hợp

Id mô hình hitem3d/hi3d/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/hitem3d/hi3d/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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,50 $ 500 tín dụng API · ≈ 53,79 ₽ Chạy trên trang này

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

Chuyển một hình ảnh thành lưới 3D, hỗ trợ chọn phiên bản Hitem3D, biến thể chân dung và nhiều định dạng xuất

Hitem3D · 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 image_url
Thả tệp hoặc

Cung cấp hình ảnh đầu vào qua URL dưới dạng tệp PNG, JPEG hoặc WebP không lớn hơn 20 MB.

resolution

Độ phân giải tạo sinh, mặc định theo đề xuất của mô hình: 1024 cho v1.5/v2.0 và tầng fast trong các trường hợp khác. Các lựa chọn khả dụng là 512, 1024, 1536 và 1536pro cho v1.5/v2.0; 1536fast và 1536pro cho v2.1; 1536 cho scene-portraitv1.5; 1536pro cho scene-portraitv2.0; và 1536profast và 1536pro cho scene-portraitv2.1.

Nâng cao model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model mặc định hitem3dv2.1

Bộ chọn mô hình tạo sinh: chọn từ dòng mô hình 'scene-portrait*' được tinh chỉnh cho chân dung và nhân vật hoặc dòng mô hình 'hitem3d*' đa dụng.

export_format mặc định glb

Định dạng dùng để lưu mô hình được tạo.

Số mặt mong muốn cho mô hình được tạo, ghi đè đề xuất dựa trên độ phân giải của đối tác. Nếu bỏ qua, đối tác sẽ chọn theo đề xuất đó, chẳng hạn 500k ở 512, 1M ở 1024 hoặc 2M ở 1536.

POST /run/hitem3d/hi3d/image-to-3d?wait=20 báo giá → 0,50 $
# 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/hitem3d/hi3d/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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ề Hi3D Image to 3D

Xây dựng mô hình 3D từ một hình ảnh (PNG, JPEG hoặc WebP, tối đa 20MB). Tùy chọn `model` gồm các biến thể tổng quát và tối ưu cho chân dung, còn các giá trị `resolution` được phép phụ thuộc vào tùy chọn này. Có thể bật hoặc tắt bản đồ kết cấu và PBR, `face_count` nằm trong khoảng 100,000 đến 2,000,000, định dạng xuất là glb, obj, stl, fbx hoặc usdz.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
modeltùy chọn
Kiểuenum
Mặc địnhhitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
Bộ chọn mô hình tạo sinh: chọn từ dòng mô hình 'scene-portrait*' được tinh chỉnh cho chân dung và nhân vật hoặc dòng mô hình 'hitem3d*' đa dụng.
resolutiontùy chọn
Kiểuenum
512102415361536pro1536fast1536profast
Độ phân giải tạo sinh, mặc định theo đề xuất của mô hình: 1024 cho v1.5/v2.0 và tầng fast trong các trường hợp khác. Các lựa chọn khả dụng là 512, 1024, 1536 và 1536pro cho v1.5/v2.0; 1536fast và 1536pro cho v2.1; 1536 cho scene-portraitv1.5; 1536pro cho scene-portraitv2.0; và 1536profast và 1536pro cho scene-portraitv2.1.
enable_texturetùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc tạo kết cấu cùng với hình học.
enable_pbrtùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc tạo bản đồ vật liệu PBR cùng với kết cấu.
face_counttùy chọn
Kiểuinteger | null
100.000 – 2.000.000
Số mặt mong muốn cho mô hình được tạo, ghi đè đề xuất dựa trên độ phân giải của đối tác. Nếu bỏ qua, đối tác sẽ chọn theo đề xuất đó, chẳng hạn 500k ở 512, 1M ở 1024 hoặc 2M ở 1536.
export_formattùy chọn
Kiểuenum
Mặc địnhglb
glbobjstlfbxusdz
Định dạng dùng để lưu mô hình được tạo.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Nút kiểm tra an toàn cho hình ảnh đầu vào: true yêu cầu kiểm tra an toàn trước khi bắt đầu xử lý hình ảnh.
image_urlbắt buộc image
Kiểuurl · image
Cung cấp hình ảnh đầu vào qua URL dưới dạng tệp PNG, JPEG hoặc WebP không lớn hơn 20 MB.
bắt buộc Tên chuẩn, cũng được chấp nhận

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": "hitem3d/hi3d/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": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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
    }
  },
  "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_mesh
object {url, content_type, file_name, file_size}Tệp chứa mô hình 3D được tạo.
thumbnail
object {url, content_type, file_name, file_size} | nullHình ảnh xem trước mô hình, được cung cấp khi có.

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