Bỏ qua đến nội dung

Hyper3D - Rodin V2.5 - Image to 3D

Tích hợp

Id mô hình hyper3d/rodin/v2.5
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: 0,40 $ 400 tín dụng API Chạy trên trang này

Lấy khóa API
Hyper3D Hình ảnh sang 3D Đầu ra 4KNhanh #image-to-3d

Chuyển ảnh thành 3D với Rodin V2.5 bằng tối đa 5 ảnh tham chiếu và lựa chọn các mức chất lượng

Hyper3D · 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.

0 / 1024

Hướng dẫn tạo sinh bằng văn bản hoặc để mô hình tự động suy ra lời nhắc từ các hình ảnh bằng cách để trống trong chế độ Image-to-3D.

Nâng cao images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition · addons
image_urls
Thả tệp hoặc · tối đa 5

URL hình ảnh nguồn, giới hạn 5 hình ảnh và bắt buộc trong chế độ Image-to-3D để tạo mô hình.

geometry_file_format mặc định glb

Định dạng tệp hình học, chọn từ glb, usdz, fbx, obj, stl; mặc định là glb.

material mặc định All

Lựa chọn đầu ra vật liệu: chọn None cho hình học không có kết cấu hoặc All để nhận cả hai biến thể vật liệu. Để có ánh sáng chân thực với vật liệu dựa trên vật lý, chọn PBR; để có ánh sáng đã nung mà không có bản đồ PBR, chọn Shaded.

texture_mode

Chọn rõ chất lượng kết cấu hoặc để API tự chọn, sử dụng giá trị mặc định phù hợp với cấp độ.

mặc định Gen-2.5-High

Cấp độ chi tiết lưới; tăng cấp độ sẽ thêm chi tiết, nhưng Gen-2.5-Minimum tự động kích hoạt chế độ minimum và buộc dùng 50K Triangle bất kể quality_mesh_option. Xem thêm trong [tài liệu](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

mặc định Auto

Chất lượng và cấu trúc liên kết lưới, với số mặt khả dụng do cấp độ quyết định: Extreme-Low, Low và Medium cho phép tối đa 1M Triangle; High và Extreme-High hỗ trợ từ 20K Triangle đến 2M Triangle. Auto áp dụng các thiết lập đề xuất: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Khi chọn thủ công, Quad ưu tiên bề mặt mượt còn Triangle ưu tiên hình học chi tiết; Hyper3D API nhận cấu trúc liên kết qua `mesh_mode` (Quad/Raw) và số mặt qua `quality_override`.

Seed ngẫu nhiên tùy chọn trong khoảng từ 0–65535.

Giới hạn kích thước tối đa của mô hình được tạo bằng ControlNet.

Lựa chọn tiện ích bổ sung tùy chọn, được cung cấp dưới dạng danh sách hoặc một giá trị đơn nếu chỉ có một tiện ích.

POST /run/hyper3d/rodin/v2.5?wait=20 báo giá → 0,40 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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ề Hyper3D - Rodin V2.5 - Image to 3D

Xây dựng mô hình 3D từ một đến năm hình ảnh trong `image_urls`, với `prompt` tùy chọn dài tối đa 1024 ký tự. Sáu cấp độ chạy từ Gen-2.5-Minimum đến Gen-2.5-Extreme-High, mặc định là High. Các tùy chọn gồm định dạng hình học (glb, usdz, fbx, obj, stl), `material`, kích thước lưới tứ giác hoặc tam giác, `TAPose` cho nhân vật thân thiện với hệ thống gắn khung xương và `hd_texture`.

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ả
prompttùy chọn
Kiểustring
Mặc định
≤ 1.024 ký tự
Hướng dẫn tạo sinh bằng văn bản hoặc để mô hình tự động suy ra lời nhắc từ các hình ảnh bằng cách để trống trong chế độ Image-to-3D.
image_urlstùy chọn images
Kiểuurl[] · image
≤ 5 mục
URL hình ảnh nguồn, giới hạn 5 hình ảnh và bắt buộc trong chế độ Image-to-3D để tạo mô hình.
tiertùy chọn
Kiểuenum
Mặc địnhGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Cấp độ chi tiết lưới; tăng cấp độ sẽ thêm chi tiết, nhưng Gen-2.5-Minimum tự động kích hoạt chế độ minimum và buộc dùng 50K Triangle bất kể quality_mesh_option. Xem thêm trong [tài liệu](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphatùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc giữ lại các kênh trong suốt của hình ảnh đầu vào khi tạo nội dung 3D.
seedtùy chọn
Kiểuinteger | null
0 – 65.535
Seed ngẫu nhiên tùy chọn trong khoảng từ 0–65535.
geometry_file_formattùy chọn
Kiểuenum
Mặc địnhglb
glbusdzfbxobjstl
Định dạng tệp hình học, chọn từ glb, usdz, fbx, obj, stl; mặc định là glb.
materialtùy chọn
Kiểuenum
Mặc địnhAll
PBRShadedAllNone
Lựa chọn đầu ra vật liệu: chọn None cho hình học không có kết cấu hoặc All để nhận cả hai biến thể vật liệu. Để có ánh sáng chân thực với vật liệu dựa trên vật lý, chọn PBR; để có ánh sáng đã nung mà không có bản đồ PBR, chọn Shaded.
quality_mesh_optiontùy chọn
Kiểuenum
Mặc địnhAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Chất lượng và cấu trúc liên kết lưới, với số mặt khả dụng do cấp độ quyết định: Extreme-Low, Low và Medium cho phép tối đa 1M Triangle; High và Extreme-High hỗ trợ từ 20K Triangle đến 2M Triangle. Auto áp dụng các thiết lập đề xuất: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Khi chọn thủ công, Quad ưu tiên bề mặt mượt còn Triangle ưu tiên hình học chi tiết; Hyper3D API nhận cấu trúc liên kết qua `mesh_mode` (Quad/Raw) và số mặt qua `quality_override`.
texture_modetùy chọn
Kiểuenum
legacyextreme-lowlowmediumhigh
Chọn rõ chất lượng kết cấu hoặc để API tự chọn, sử dụng giá trị mặc định phù hợp với cấp độ.
enable_creative_modetùy chọn
Kiểuboolean
Mặc địnhfalse
Chế độ tạo sinh sáng tạo, tương đương với `geometry_instruct_mode` đặt thành `creative` trong Hyper3D API. Khi bật, chế độ này giúp quá trình tạo sinh ổn định hơn mà không làm giảm tính nhất quán của đầu ra.
hd_texturetùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát hậu xử lý kết cấu nâng cao để cải thiện độ trung thực hình ảnh.
texture_delighttùy chọn
Kiểuboolean
Mặc địnhfalse
Loại bỏ ánh sáng và vùng sáng được tích hợp khỏi các kết cấu đã tạo.
is_microtùy chọn
Kiểuboolean
Mặc địnhfalse
Thêm chi tiết hình học tinh hơn ở cấp vi mô; chỉ có hiệu lực khi `tier="Gen-2.5-Extreme-High"`.
TAPosetùy chọn
Kiểuboolean
Mặc địnhfalse
Thiết lập tư thế nhân vật để dễ tạo khung xương và hoạt ảnh trong phần mềm 3D: khi bật, nhân vật được tạo ở tư thế T hoặc A.
bbox_conditiontùy chọn
Kiểuobject
Giới hạn kích thước tối đa của mô hình được tạo bằng ControlNet.
bbox_condition.widthtùy chọn
Kiểuinteger
Mặc định0
1 – 2.048
Ràng buộc chiều rộng của hộp giới hạn trên trục x.
bbox_condition.heighttùy chọn
Kiểuinteger
Mặc định0
1 – 2.048
Ràng buộc chiều cao của hộp giới hạn trên trục y.
bbox_condition.lengthtùy chọn
Kiểuinteger
Mặc định0
1 – 2.048
Ràng buộc chiều dài của hộp giới hạn trên trục z.
addonstùy chọn
Kiểuobject
Lựa chọn tiện ích bổ sung tùy chọn, được cung cấp dưới dạng danh sách hoặc một giá trị đơn nếu chỉ có một tiện ích.
addons.high_packtùy chọn
Kiểuboolean
Mặc địnhfalse
Cải tiến HighPack: đầu ra Quad có số mặt xấp xỉ gấp 16 lần số mặt được yêu cầu qua tham số chất lượng, và kết cấu sử dụng độ phân giải 4K thay vì mặc định 2K.
preview_rendertùy chọn
Kiểuboolean
Mặc địnhfalse
Nút bật/tắt kết xuất xem trước, thêm hình ảnh hiển thị mô hình 3D đã tạo vào các tệp mô hình được trả về.
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.
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": "hyper3d/rodin/v2.5",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "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
    },
    "model_meshes": [
      {
        "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,
    "textures": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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 đối tượng 3D đã tạo.
model_meshes
array of object {url, content_type, file_name, file_size}Các tệp đối tượng 3D bổ sung do Hyper3D tạo và trả về cùng với model_mesh.
seed
integerSeed được áp dụng trong quá trình tạo sinh.
textures
array of object {url, content_type, file_name, file_size, width, height}Các kết cấu được tạo cho đối tượng 3D.

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