Bỏ qua đến nội dung

Hyper3D - Rodin V2.5 - Image to 3D - Fast

Tích hợp

Id mô hình hyper3d/rodin/v2.5/fast
# 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/fast?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,10 $ 100 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

Rodin V2.5 chuyển ảnh thành 3D nhanh, giới hạn ở ba mức thấp nhất để tạo mẫu nhanh

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
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 Shaded

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-Extreme-Low

Cấp độ tạo sinh; Gen-2.5-Minimum buộc dùng chế độ minimum và lưới 50K Triangle bất kể `quality_mesh_option`. Chi tiết cấp độ có trong [tài liệu Hyper3D](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ọn chất lượng cùng cấu trúc liên kết lưới: Quad ưu tiên bề mặt mượt, còn Triangle ưu tiên chi tiết hình học. Điểm cuối nhanh chủ yếu dành cho kiểm thử và tạo nguyên mẫu, với giới hạn 20K; dùng điểm cuối tiêu chuẩn để có lưới chất lượng cao hơn, trong đó Minimum, Extreme-Low và Low hỗ trợ tối đa 1M Triangle, với số mặt khả dụng tùy cấp độ. Trong Hyper3D API, `quality_override` chỉ định số mặt, còn `mesh_mode` chỉ định Quad/Raw. Auto chọn các thiết lập đề xuất: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

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.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 báo giá → 0,10 $
# 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/fast?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 - Fast

Tạo mô hình 3D từ một đến năm ảnh trong `image_urls`, với `prompt` tùy chọn. `tier` chỉ giới hạn ở Minimum, Extreme-Low (mặc định) và Low, còn tùy chọn lưới tối đa 20K mặt. Material mặc định là Shaded. Định dạng đầu ra là glb, usdz, fbx, obj hoặc stl.

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ả
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-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Cấp độ tạo sinh; Gen-2.5-Minimum buộc dùng chế độ minimum và lưới 50K Triangle bất kể `quality_mesh_option`. Chi tiết cấp độ có trong [tài liệu Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
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.
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 địnhShaded
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
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Chọn chất lượng cùng cấu trúc liên kết lưới: Quad ưu tiên bề mặt mượt, còn Triangle ưu tiên chi tiết hình học. Điểm cuối nhanh chủ yếu dành cho kiểm thử và tạo nguyên mẫu, với giới hạn 20K; dùng điểm cuối tiêu chuẩn để có lưới chất lượng cao hơn, trong đó Minimum, Extreme-Low và Low hỗ trợ tối đa 1M Triangle, với số mặt khả dụng tùy cấp độ. Trong Hyper3D API, `quality_override` chỉ định số mặt, còn `mesh_mode` chỉ định Quad/Raw. Auto chọn các thiết lập đề xuất: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
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.
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/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "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/fast.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt