Bỏ qua đến nội dung

Tripo3D · Multiview to 3D

Tích hợp

Id mô hình tripo3d/tripo/v2.5/multiview-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/tripo3d/tripo/v2.5/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "front_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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,30 $ 300 tín dụng API · ≈ 32,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
Tripo · 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
Thả tệp hoặc

Hình ảnh hiển thị đối tượng từ phía trước.

texture mặc định standard

Thiết lập họa tiết cho mô hình: 'standard' là mặc định, 'no' tắt họa tiết và 'HD' tạo họa tiết độ phân giải cao.

Thiết lập kiểu; để trống để giữ nguyên diện mạo và kiểu ban đầu.

Nâng cao left_image_url · back_image_url · right_image_url · texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
Thả tệp hoặc

Hình ảnh hiển thị đối tượng từ bên trái.

Thả tệp hoặc

Hình ảnh hiển thị đối tượng từ phía sau.

Thả tệp hoặc

Hình ảnh hiển thị đối tượng từ bên phải.

texture_alignment mặc định original_image

Thiết lập ưu tiên căn chỉnh họa tiết cho mô hình 3D, sử dụng original_image trừ khi cung cấp giá trị khác.

orientation mặc định default

Hướng của mô hình, ban đầu được đặt thành `default`. Chọn `align_image` để tự động xoay mô hình sao cho thẳng hàng với hình ảnh gốc.

Giới hạn số mặt đầu ra, được chọn thích ứng trừ khi bạn cung cấp giới hạn cụ thể.

Seed số nguyên kiểm soát việc tạo sinh hình học; sử dụng lại seed này sẽ tạo ra các mô hình giống hệt nhau. Khi bỏ qua, một giá trị ngẫu nhiên được chọn.

Seed tạo họa tiết, được cung cấp dưới dạng số nguyên hoặc chọn ngẫu nhiên khi bỏ qua. Các giá trị seed giống nhau sẽ tạo lại họa tiết; để thay đổi họa tiết của mô hình, thay đổi texture_seed trong khi giữ seed mô hình không đổi.

POST /run/tripo3d/tripo/v2.5/multiview-to-3d?wait=20 báo giá → 0,30 $
# 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/tripo3d/tripo/v2.5/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "front_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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ề Tripo3D · Multiview to 3D

Tạo mô hình 3D từ `front_image_url` bắt buộc và các `left_image_url`, `back_image_url`, `right_image_url` tùy chọn, nhờ đó các góc nhìn bổ sung có thể cải thiện hình học. Kết cấu có thể là no, standard hoặc HD, với PBR tùy chọn. Mô hình cũng cung cấp thiết lập sẵn phong cách, `face_limit`, đầu ra quad (bắt buộc FBX), tự động điều chỉnh kích thước, căn chỉnh kết cấu và điều khiển hướng, cùng các seed riêng cho hình học và kết cấu.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
seedtùy chọn
Kiểuinteger | null
Seed số nguyên kiểm soát việc tạo sinh hình học; sử dụng lại seed này sẽ tạo ra các mô hình giống hệt nhau. Khi bỏ qua, một giá trị ngẫu nhiên được chọn.
face_limittùy chọn
Kiểuinteger | null
Giới hạn số mặt đầu ra, được chọn thích ứng trừ khi bạn cung cấp giới hạn cụ thể.
pbrtùy chọn
Kiểuboolean | null
Mặc địnhfalse
Công tắc PBR: False tạo mô hình không có PBR, còn True ghi đè thiết lập họa tiết và coi thiết lập đó là True. PBR được bật theo mặc định.
texturetùy chọn
Kiểuenum
Mặc địnhstandard
nostandardHD
Thiết lập họa tiết cho mô hình: 'standard' là mặc định, 'no' tắt họa tiết và 'HD' tạo họa tiết độ phân giải cao.
texture_seedtùy chọn
Kiểuinteger | null
Seed tạo họa tiết, được cung cấp dưới dạng số nguyên hoặc chọn ngẫu nhiên khi bỏ qua. Các giá trị seed giống nhau sẽ tạo lại họa tiết; để thay đổi họa tiết của mô hình, thay đổi texture_seed trong khi giữ seed mô hình không đổi.
auto_sizetùy chọn
Kiểuboolean | null
Mặc địnhfalse
Công tắc kích thước thực tế, tắt theo mặc định (False), tự động điều chỉnh kích thước mô hình bằng mét.
styletùy chọn
Kiểuenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Thiết lập kiểu; để trống để giữ nguyên diện mạo và kiểu ban đầu.
quadtùy chọn
Kiểuboolean | null
Mặc địnhfalse
Chế độ tứ giác buộc đầu ra FBX khi được bật. Với quad=True và không chỉ định face_limit, face_limit mặc định là 10000.
texture_alignmenttùy chọn
Kiểuenum
Mặc địnhoriginal_image
original_imagegeometry
Thiết lập ưu tiên căn chỉnh họa tiết cho mô hình 3D, sử dụng original_image trừ khi cung cấp giá trị khác.
orientationtùy chọn
Kiểuenum
Mặc địnhdefault
defaultalign_image
Hướng của mô hình, ban đầu được đặt thành `default`. Chọn `align_image` để tự động xoay mô hình sao cho thẳng hàng với hình ảnh gốc.
front_image_urlbắt buộc
Kiểuurl · image
Hình ảnh hiển thị đối tượng từ phía trước.
left_image_urltùy chọn
Kiểuurl · image
Hình ảnh hiển thị đối tượng từ bên trái.
back_image_urltùy chọn
Kiểuurl · image
Hình ảnh hiển thị đối tượng từ phía sau.
right_image_urltùy chọn
Kiểuurl · image
Hình ảnh hiển thị đối tượng từ bên phải.
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": "tripo3d/tripo/v2.5/multiview-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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "front_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "task_id": "string",
    "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
    },
    "base_model": {
      "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
    },
    "pbr_model": {
      "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
    },
    "rendered_image": {
      "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
    }
  },
  "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
task_id
stringMã định danh tác vụ để tạo mô hình 3D.
model_mesh
object {url, content_type, file_name, file_size} | nullĐầu ra mô hình.
base_model
object {url, content_type, file_name, file_size} | nullĐầu ra mô hình cơ sở.
pbr_model
object {url, content_type, file_name, file_size} | nullĐầu ra mô hình PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullHình ảnh hiển thị bản xem trước của mô hình.

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