Bỏ qua đến nội dung

Hyper3d

Tích hợp

Id mô hình hyper3d/rodin/v2
# 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/hyper3d/rodin/v2?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.ru/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 · ≈ 42,19 ₽ Chạy trên trang này

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

Rodin v2 chuyển văn bản hoặc hình ảnh thành 3D, hỗ trợ tối đa 5 hình ảnh đầu vào, thiết lập sẵn lưới tứ giác hoặc tam giác và kết xuất xem trước

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 lời nhắc văn bản hoặc để trống trong chế độ Image-to-3D để AI suy ra lời nhắc từ các hình ảnh của bạn.

Nâng cao input_image_urls · geometry_file_format · material · quality_mesh_option · addons · seed · use_original_alpha · TAPose · preview_render · bbox_condition
Thả tệp hoặ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.

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 vật liệu, trong đó All bao gồm cả hai phương án: PBR sử dụng phương pháp dựa trên vật lý để tạo ánh sáng chân thực, còn Shaded sử dụng vật liệu đơn giản và ánh sáng đã được nung.

quality_mesh_option mặc định 500K Triangle

Lựa chọn kết hợp lưới và chất lượng, được ánh xạ trong Hyper3D API sang `quality_override` bằng phần số của tùy chọn và sang `mesh_mode` bằng 'Raw' nếu tùy chọn chứa 'Triangle', hoặc 'Quad' nếu không. Quad ưu tiên bề mặt mượt; Triangle ưu tiên hình học chi tiết.

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.

Kích thước hộp giới hạn dưới dạng mảng theo thứ tự [width, height, length].

POST /run/hyper3d/rodin/v2?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.ru/v1/run/hyper3d/rodin/v2?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.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ề Hyper3d

Tạo mô hình 3D từ lời nhắc (tối đa 1024 ký tự) và tối đa 5 hình ảnh trong `input_image_urls`. `quality_mesh_option` cung cấp lưới tứ giác từ 4K đến 50K và lưới tam giác từ 2K đến 500K. Hỗ trợ `material` PBR, Shaded hoặc All, `TAPose`, `use_original_alpha` và `preview_render`.

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 bằng lời nhắc văn bản hoặc để trống trong chế độ Image-to-3D để AI suy ra lời nhắc từ các hình ảnh của bạn.
input_image_urlstùy chọn
Kiểuurl[] · image
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.
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
PBRShadedAll
Lựa chọn vật liệu, trong đó All bao gồm cả hai phương án: PBR sử dụng phương pháp dựa trên vật lý để tạo ánh sáng chân thực, còn Shaded sử dụng vật liệu đơn giản và ánh sáng đã được nung.
quality_mesh_optiontùy chọn
Kiểuenum
Mặc định500K Triangle
4K Quad8K Quad18K Quad50K Quad2K Triangle20K Triangle150K Triangle500K Triangle
Lựa chọn kết hợp lưới và chất lượng, được ánh xạ trong Hyper3D API sang `quality_override` bằng phần số của tùy chọn và sang `mesh_mode` bằng 'Raw' nếu tùy chọn chứa 'Triangle', hoặc 'Quad' nếu không. Quad ưu tiên bề mặt mượt; Triangle ưu tiên hình học chi tiết.
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ểuinteger[]
Kích thước hộp giới hạn dưới dạng mảng theo thứ tự [width, height, length].
addonstùy chọn
Kiểustring | null
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.
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ề.
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/v2",
  "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.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 đố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.

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