Bỏ qua đến nội dung

Tripo3D · Image to 3D

Tích hợp

Id mô hình tripo3d/tripo/v2.5/image-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/image-to-3d?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.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,19 ₽ 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 Hình ảnh sang 3D #image-to-3d#stylized

Chuyển hình ảnh thành 3D (v2.5) với thiết lập sẵn phong cách, kết cấu HD, đầu ra quad và các tùy chọn căn chỉnh

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 dùng để tạo mô hình.

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 texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
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/image-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/image-to-3d?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.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 · Image to 3D

Tạo mô hình 3D từ một `image_url` duy nhất. `texture` có thể là no, standard hoặc HD, với đầu ra PBR tùy chọn. Thiết lập sẵn `style` như clay, steampunk, gold hoặc ancient bronze có thể thay đổi phong cách của kết quả. Các điều khiển khác gồm `face_limit`, `quad` (bắt buộc FBX), `auto_size`, `texture_alignment` và `orientation` để căn chỉnh mô hình với hình ảnh.

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ả
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.
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh dùng để tạo mô hình.
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/tripo/v2.5/image-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": {
    "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/image-to-3d.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt