Bỏ qua đến nội dung

Tripo P2 Text to 3D

Tích hợp

Id mô hình tripo3d/p2/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/tripo3d/p2/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ụ: 1,10 $ 1.100 tín dụng API · ≈ 118,34 ₽ 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 Văn bản sang 3D #3d#text-to-3d#3d-generation#low-poly

Văn bản sang 3D với PBR, lưới quad, phiên bản kết cấu có thể chọn và lời nhắc phủ định, biến thể văn bản P2

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 88 / 1024

Mô tả bằng văn bản về đối tượng 3D mong muốn, giới hạn ở 1024 ký tự.

texture_quality mặc định standard

Thiết lập chất lượng cho họa tiết.

Nâng cao negative_prompt · texture_version · export_orientation · face_limit · image_seed · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
0 / 255

Mô tả các đặc điểm cần loại trừ khỏi mô hình được tạo sinh.

texture_version

Phiên bản dùng để tạo mô hình họa tiết. Để có chất lượng nhanh, chọn v3.5-20260815; các phiên bản khác không được hỗ trợ cho chất lượng đó.

export_orientation

Thiết lập trục trước cho việc xuất mô hình, nếu được chỉ định.

Giới hạn trên của số mặt lưới, với giới hạn riêng là 25,000 cho cấu trúc liên kết tứ giác.

Seed được dùng trong giai đoạn chuyển văn bản thành hình ảnh nội bộ.

Seed dùng để tạo sinh hình học có thể tái lập.

Seed dùng để tạo sinh họa tiết có thể tái lập.

POST /run/tripo3d/p2/text-to-3d?wait=20 báo giá → 1,10 $
# 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/p2/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ề Tripo P2 Text to 3D

Tạo mô hình 3D từ lời nhắc tối đa 1024 ký tự, với `negative_prompt` tối đa 255 ký tự. Lưới có tối đa 50,000 mặt, hoặc 25,000 khi bật `quad`. Chất lượng kết cấu từ fast đến extreme, với `texture_version` có thể chọn, PBR tùy chọn, delighting và xuất UV. Có seed cho bước hình ảnh, hình học và kết cấu.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
≤ 1.024 ký tự
Mô tả bằng văn bản về đối tượng 3D mong muốn, giới hạn ở 1024 ký tự.
negative_prompttùy chọn
Kiểustring | null
≤ 255 ký tự
Mô tả các đặc điểm cần loại trừ khỏi mô hình được tạo sinh.
image_seedtùy chọn
Kiểuinteger | null
Seed được dùng trong giai đoạn chuyển văn bản thành hình ảnh nội bộ.
model_seedtùy chọn
Kiểuinteger | null
Seed dùng để tạo sinh hình học có thể tái lập.
face_limittùy chọn
Kiểuinteger | null
48 – 50.000
Giới hạn trên của số mặt lưới, với giới hạn riêng là 25,000 cho cấu trúc liên kết tứ giác.
texturetùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc mô hình có nhận các kết cấu được tạo hay không.
pbrtùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc tạo sinh các bản đồ vật liệu PBR. Bật PBR cũng kích hoạt họa tiết.
texture_seedtùy chọn
Kiểuinteger | null
Seed dùng để tạo sinh họa tiết có thể tái lập.
texture_qualitytùy chọn
Kiểuenum
Mặc địnhstandard
faststandarddetailedextreme
Thiết lập chất lượng cho họa tiết.
texture_versiontùy chọn
Kiểuenum
v3.5-20260815v3.0-20250812v2.5-20250123
Phiên bản dùng để tạo mô hình họa tiết. Để có chất lượng nhanh, chọn v3.5-20260815; các phiên bản khác không được hỗ trợ cho chất lượng đó.
delighttùy chọn
Kiểuboolean
Mặc địnhtrue
Loại bỏ ánh sáng tích hợp trước khi tạo họa tiết bằng v3.5-20260815.
auto_sizetùy chọn
Kiểuboolean
Mặc địnhfalse
Tự động chia tỷ lệ để cung cấp cho mô hình kích thước thực tế được đo bằng mét.
export_uvtùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc mô hình có nhận được tọa độ UV được tạo sinh hay không.
export_orientationtùy chọn
Kiểuenum
+x-x-y+y
Thiết lập trục trước cho việc xuất mô hình, nếu được chỉ định.
quadtùy chọn
Kiểuboolean
Mặc địnhfalse
Cấu trúc liên kết lưới sử dụng tứ giác thay vì tam giác.
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": "tripo3d/p2/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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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_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
      },
      "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
    },
    "task_id": "string"
  },
  "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 GLB hoặc FBX chứa mô hình 3D được tạo sinh, với định dạng do dữ liệu Tripo tạo ra quyết định.
model_urls
object {glb, fbx, base_model, pbr_model}Các URL trỏ đến những phiên bản thay thế của mô hình 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullBản xem trước đã kết xuất hiển thị mô hình 3D được tạo sinh.
task_id
string | nullID tác vụ Tripo có thể tái sử dụng, xác định mô hình được tạo sinh cho rig hoặc rig-check, cho phép thực hiện các thao tác đó mà không cần tải lên mô hình khác.

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