Bỏ qua đến nội dung

Hyper3D - Rodin V2.5 - Text to 3D

Tích hợp

Id mô hình hyper3d/rodin/v2.5/text-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/hyper3d/rodin/v2.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 · ≈ 43,03 ₽ Chạy trên trang này

Lấy khóa API
Hyper3D Văn bản sang 3D Đầu ra 4KNhanh #text-to-3d

Chuyển văn bản thành 3D với Rodin V2.5 qua sáu cấp độ, từ lời nhắc dài tối đa 1024 ký tự

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.

•bắt buộc 88 / 1024

Hướng dẫn văn bản định hướng quá trình tạo mô hình; bắt buộc trong chế độ Text-to-3D.

Nâng cao geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
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.

Các tùy chọn bổ sung cần áp dụng, nếu cần.

POST /run/hyper3d/rodin/v2.5/text-to-3d?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.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 - Rodin V2.5 - Text to 3D

Tạo mô hình 3D từ `prompt` bắt buộc tối đa 1024 ký tự. Chọn `tier` từ Gen-2.5-Minimum đến Gen-2.5-Extreme-High (mặc định High), kích thước lưới theo tứ giác hoặc tam giác và `material` như PBR hoặc Shaded. Xuất dưới dạng glb, usdz, fbx, obj hoặc stl, và đặt `seed` từ 0 đến 65535.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
≤ 1.024 ký tự
Hướng dẫn văn bản định hướng quá trình tạo mô hình; bắt buộc trong chế độ Text-to-3D.
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).
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
Các tùy chọn bổ sung cần áp dụng, nếu cần.
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.
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

Đầu ra

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.

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