Bỏ qua đến nội dung

Triposplat

Tích hợp

Id mô hình tripo3d/triposplat
# 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/tripo3d/triposplat?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: 0,05 $ 50 tín dụng API 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 image_url
Thả tệp hoặc

URL hình ảnh nguồn để chuyển đổi thành Gaussian splat 3D.

Nâng cao output_format · num_gaussians · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format mặc định ply

Định dạng tệp đầu ra cho Gaussian splat.

mặc định 262144

Số lượng Gaussian mong muốn cho splat được tạo sinh, được làm tròn nội bộ đến bội số gần nhất của 32. Tăng giá trị này sẽ thêm chi tiết nhưng cũng làm tăng kích thước tệp và làm chậm quá trình kết xuất.

mặc định 20

Số bước cho bộ lấy mẫu flow-matching.

mặc định 3

Kiểm soát hướng dẫn không cần bộ phân loại, trong đó các thiết lập mạnh hơn sẽ thêm chi tiết và đưa kết quả gần hơn với hình ảnh nguồn, nhưng có nguy cơ làm màu quá bão hòa. Hướng dẫn bị tắt ở mức 1.0 trở xuống.

Seed dùng để tái tạo kết quả. Đặt thành None sẽ chọn seed ngẫu nhiên.

POST /run/tripo3d/triposplat?wait=20 báo giá → 0,05 $
# 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/tripo3d/triposplat?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.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ề Triposplat

Tạo Gaussian splat 3D từ một hình ảnh duy nhất (`image_url`) thay vì lưới. `num_gaussians` nằm trong khoảng từ 32,768 đến 262,144, còn `output_format` là ply hoặc splat. Bạn cũng có thể đặt `num_inference_steps` (1-50), `guidance_scale` và `seed`. Phản hồi bao gồm số Gaussian thực tế và hình ảnh đã xóa nền mà mô hình đã sử dụng.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh nguồn để chuyển đổi thành Gaussian splat 3D.
num_gaussianstùy chọn
Kiểuinteger
Mặc định262144
32.768 – 262.144
Số lượng Gaussian mong muốn cho splat được tạo sinh, được làm tròn nội bộ đến bội số gần nhất của 32. Tăng giá trị này sẽ thêm chi tiết nhưng cũng làm tăng kích thước tệp và làm chậm quá trình kết xuất.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định20
1 – 50
Số bước cho bộ lấy mẫu flow-matching.
guidance_scaletùy chọn
Kiểunumber
Mặc định3
0 – 10
Kiểm soát hướng dẫn không cần bộ phân loại, trong đó các thiết lập mạnh hơn sẽ thêm chi tiết và đưa kết quả gần hơn với hình ảnh nguồn, nhưng có nguy cơ làm màu quá bão hòa. Hướng dẫn bị tắt ở mức 1.0 trở xuống.
output_formattùy chọn
Kiểuenum
Mặc địnhply
plysplat
Định dạng tệp đầu ra cho Gaussian splat.
seedtùy chọn
Kiểuinteger | null
Seed dùng để tái tạo kết quả. Đặt thành None sẽ chọn seed ngẫu nhiên.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc kiểm tra an toàn cho hình ảnh nguồn.
bắt buộc Tên chuẩn, cũng được chấp nhận

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/triposplat",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
    },
    "preprocessed_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,
      "width": 1024,
      "height": 768
    },
    "num_gaussians": 1,
    "seed": 42,
    "timings": {}
  },
  "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 đầu ra chứa Gaussian splat 3D, ở định dạng .ply hoặc .splat.
preprocessed_image
object {url, content_type, file_name, file_size, width, height}Hình ảnh thực sự được mô hình sử dụng: ảnh ghép RGB hiển thị tiền cảnh trên nền đen sau khi xóa nền.
num_gaussians
integerSố lượng Gaussian được tạo sinh thực tế.
seed
integerGiá trị seed được áp dụng trong quá trình tạo sinh.
timings
objectThời gian dành cho từng giai đoạn, tính bằng giây.

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