3D
Tạo Mô hình 3D
Tạo một tác vụ tạo mô hình 3D
Tạo các mô hình 3D từ văn bản hoặc hình ảnh bằng cách sử dụng Tripo3D và các nhà cung cấp khác. Đây là một API bất đồng bộ. Phản hồi tạo trả về danh tính tác vụ và, khi có sẵn, cũng có thể bao gồm poll_url ưu tiên.
Các operation 3D công khai được suy luận từ hình dạng request: request chỉ có prompt được xử lý là text-to-3d, còn request có image hoặc image_url được xử lý là image-to-3d. Endpoint này không công khai trường request operation; đừng gửi giá trị legacy 3d-generation.
Nội dung yêu cầu
Trước khi gửi các trường tùy chọn, hãy kiểm tra tham số được mô hình chấp nhận qua GET /v1/models/{model}. Ví dụ chỉ gửi model và prompt.
tripo-h3.1Mô hình cần dùng, ví dụ tripo-h3.1 hoặc tripo-p1.0. Hãy gọi GET /v1/models?recommended_for=3d trước khi chọn loại đầu vào hoặc định dạng đầu ra.
Mô tả văn bản của mô hình 3D cần tạo.
Hình ảnh được mã hóa Base64 để tạo mô hình 3D từ hình ảnh.
URL của hình ảnh để tạo mô hình 3D từ hình ảnh.
Định dạng đầu ra; khả năng hỗ trợ và các giá trị cho phép phụ thuộc vào mô hình đã chọn.
Thiết lập chất lượng; khả năng hỗ trợ và các giá trị cho phép phụ thuộc vào mô hình đã chọn.
Phong cách thiết lập sẵn cho mô hình.
Seed số nguyên, khi mô hình đã chọn hỗ trợ.
Một mã định danh duy nhất cho người dùng cuối.
Phản hồi
ID tác vụ để kiểm tra trạng thái (polling).
Bí danh của mã tác vụ bất đồng bộ khi được adapter trả về.
URL polling ưu tiên khi có sẵn.
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
Dấu thời gian Unix của thời điểm tạo tác vụ.
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'Phản hồi
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Xác thực
BearerAuth Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Header
Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.
Giá trị hợp lệ
- "auto"
- "verified"
- "official"
Nội dung yêu cầu
application/json
Phản hồi
application/json
application/json