Bỏ qua đến nội dung

Hunyuan3d V3 · Text to 3D

Tích hợp

Id mô hình hunyuan3d-v3/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/hunyuan3d-v3/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"

Các tệp như ví dụ: 0,375 $ 375 tín dụng API · ≈ 40,24 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Tencent · 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

Lời nhắc tạo sinh cho phép tối đa 1024 ký tự UTF-8 để chỉ định nội dung 3D cần tạo.

generate_type mặc định Normal

Chế độ tạo sinh: `Normal` tạo mô hình có kết cấu; `LowPoly` giảm số đa giác; `Geometry` tạo mô hình trắng không có kết cấu.

mặc định 500000

Số mặt mong muốn, trong khoảng từ 40,000 đến 1,500,000.

Nâng cao polygon_type · enable_safety_checker
polygon_type mặc định triangle

Loại đa giác, chỉ áp dụng khi `GenerateType` là `LowPoly`.

POST /run/hunyuan3d-v3/text-to-3d?wait=20 báo giá → 0,375 $
# 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/hunyuan3d-v3/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ề Hunyuan3d V3 · Text to 3D

Tạo mô hình 3D từ `prompt` dài tối đa 1024 ký tự, không cần hình ảnh. `generate_type` chọn mô hình Normal có kết cấu, bản rút gọn LowPoly hoặc mô hình Geometry màu trắng; `polygon_type` đặt tam giác hoặc tứ giác cho LowPoly. `enable_pbr` thêm vật liệu PBR và `face_count` nằm trong khoảng từ 40000 đến 1500000.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
≤ 1.024 ký tự
Lời nhắc tạo sinh cho phép tối đa 1024 ký tự UTF-8 để chỉ định nội dung 3D cần tạo.
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.
enable_pbrtùy chọn
Kiểuboolean
Mặc địnhfalse
Nút bật/tắt tạo vật liệu PBR.
face_counttùy chọn
Kiểuinteger
Mặc định500000
40.000 – 1.500.000
Số mặt mong muốn, trong khoảng từ 40,000 đến 1,500,000.
generate_typetùy chọn
Kiểuenum
Mặc địnhNormal
NormalLowPolyGeometry
Chế độ tạo sinh: `Normal` tạo mô hình có kết cấu; `LowPoly` giảm số đa giác; `Geometry` tạo mô hình trắng không có kết cấu.
polygon_typetùy chọn
Kiểuenum
Mặc địnhtriangle
trianglequadrilateral
Loại đa giác, chỉ áp dụng khi `GenerateType` là `LowPoly`.
bắt buộc

Đầu ra

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "model_glb": {
      "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
    },
    "thumbnail": {
      "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_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
  },
  "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_glb
object {url, content_type, file_name, file_size}Tệp GLB chứa đối tượng 3D được tạo.
thumbnail
object {url, content_type, file_name, file_size} | nullHình thu nhỏ hiển thị bản xem trước của mô hình được tạo.
model_urls
object {glb, fbx, obj, usdz}Liên kết đến mô hình 3D ở nhiều định dạng.
seed
integer | nullGiá trị seed dùng trong quá trình tạo sinh.

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