Bỏ qua đến nội dung

Hyper3D Rodin

Tích hợp

Id mô hình hyper3d/rodin
# 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?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 Nhanh #stylized

Tạo 3D Rodin từ văn bản hoặc ảnh với vật liệu PBR hoặc đổ bóng và 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 được cung cấp dưới dạng văn bản; chế độ Text-to-3D bắt buộc có, còn Image-to-3D có thể bỏ qua.

Nâng cao input_image_urls · condition_mode · geometry_file_format · material · quality · tier · addons · seed · use_hyper · TAPose · bbox_condition
Thả tệp hoặc

URL hình ảnh nguồn; Image-to-3D bắt buộc có, còn Text-to-3D có thể tùy chọn sử dụng để tạo mô hình.

condition_mode mặc định concat

Phương thức điều kiện hóa hình ảnh: concat xây dựng mô hình từ nhiều góc nhìn của một đối tượng, không yêu cầu thứ tự tải lên. Ngoài ra, fuse yêu cầu một hoặc nhiều hình ảnh và tạo mô hình bằng cách trích xuất các đặc trưng đối tượng rồi kết hợp chúng giữa các hình ả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 PBR

Lựa chọn vật liệu: PBR hoặc Shaded, trong đó PBR là mặc định.

quality mặc định medium

Mức chất lượng tạo sinh: high, medium, low, extra-low; mặc định là medium.

tier mặc định Regular

Lựa chọn cấp tạo sinh: dùng Sketch cho Rodin Sketch hoặc Regular cho Rodin Regular.

Tiện ích bổ sung tạo sinh tùy chọn; mặc định là []. Tùy chọn HighPack cung cấp mô hình nhiều đa giác và nâng độ phân giải kết cấu từ 1K mặc định lên 4K.

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

Mảng hộp giới hạn, thường gồm 3 phần tử: chiều dài trên trục X, chiều rộng trên trục Y và chiều cao trên trục Z. Các giá trị này chỉ định kích thước và hệ số tỷ lệ của hộp.

POST /run/hyper3d/rodin?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?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

Tạo mô hình 3D từ lời nhắc dài tối đa 1024 ký tự, hình ảnh đầu vào hoặc cả hai. `condition_mode` là fuse hoặc concat cho đầu vào nhiều hình ảnh. Các tùy chọn gồm `quality` từ extra-low đến high, `material` PBR hoặc Shaded, `tier` Regular hoặc Sketch, `TAPose`, `bbox_condition` và xuất glb, usdz, fbx, obj hoặc stl.

Tham số

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 được cung cấp dưới dạng văn bản; chế độ Text-to-3D bắt buộc có, còn Image-to-3D có thể bỏ qua.
input_image_urlstùy chọn
Kiểuurl[] · image
URL hình ảnh nguồn; Image-to-3D bắt buộc có, còn Text-to-3D có thể tùy chọn sử dụng để tạo mô hình.
condition_modetùy chọn
Kiểuenum
Mặc địnhconcat
fuseconcat
Phương thức điều kiện hóa hình ảnh: concat xây dựng mô hình từ nhiều góc nhìn của một đối tượng, không yêu cầu thứ tự tải lên. Ngoài ra, fuse yêu cầu một hoặc nhiều hình ảnh và tạo mô hình bằng cách trích xuất các đặc trưng đối tượng rồi kết hợp chúng giữa các hình ảnh.
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 địnhPBR
PBRShaded
Lựa chọn vật liệu: PBR hoặc Shaded, trong đó PBR là mặc định.
qualitytùy chọn
Kiểuenum
Mặc địnhmedium
highmediumlowextra-low
Mức chất lượng tạo sinh: high, medium, low, extra-low; mặc định là medium.
use_hypertùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc xuất mô hình hyper-mode; mặc định là false.
tiertùy chọn
Kiểuenum
Mặc địnhRegular
RegularSketch
Lựa chọn cấp tạo sinh: dùng Sketch cho Rodin Sketch hoặc Regular cho Rodin Regular.
TAPosetùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc tạo mô hình giống người ở tư thế T/A.
bbox_conditiontùy chọn
Kiểuinteger[]
Mảng hộp giới hạn, thường gồm 3 phần tử: chiều dài trên trục X, chiều rộng trên trục Y và chiều cao trên trục Z. Các giá trị này chỉ định kích thước và hệ số tỷ lệ của hộp.
addonstùy chọn
Kiểustring | null
Tiện ích bổ sung tạo sinh tùy chọn; mặc định là []. Tùy chọn HighPack cung cấp mô hình nhiều đa giác và nâng độ phân giải kết cấu từ 1K mặc định lên 4K.
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": "hyper3d/rodin",
  "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
    },
    "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.
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.

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/hyper3d/rodin.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt