3D
Tạo mô hình 3D
Tạo tác vụ tạo mô hình 3D
Sử dụng GET /v1/models?recommended_for=3d để lấy các mô hình 3D hiện có.
Tạo mô hình 3D từ văn bản hoặc hình ảnh. Đây là một API bất đồng bộ (asynchronous). Các phản hồi tạo (create responses) sẽ trả về một định danh tác vụ (task identity). Hãy thực hiện poll GET /v1/tasks/{id} với định danh đó để kiểm tra trạng thái.
Thao tác (operation) có thể là text-to-3d hoặc image-to-3d. Bạn có thể bỏ qua trường operation: các yêu cầu chỉ có prompt sẽ mặc định là text-to-3d, và các yêu cầu có image hoặc image_url sẽ mặc định là image-to-3d. Nếu bạn gửi operation, nó phải khớp với các đầu vào: image-to-3d cần một hình ảnh, và text-to-3d không nhận hình ảnh. Giá trị cũ 3d-generation sẽ trả về lỗi 400 unsupported_operation. Mỗi mô hình chỉ hỗ trợ một số thao tác nhất định; hãy kiểm tra GET /v1/models/{model}.
Phần thân yêu cầu (Request Body)
Trước khi gửi các trường tùy chọn, hãy kiểm tra GET /v1/models/{model} để biết các tham số được chấp nhận của mô hình đó. Ví dụ dưới đây chỉ sử dụng model và prompt.
tripo-h3.1Mô hình cần sử dụng, ví dụ tripo-h3.1 hoặc tripo-p1.0. Hãy truy vấn GET /v1/models?recommended_for=3d trước khi dựa vào một loại đầu vào hoặc định dạng đầu ra cụ thể.
text-to-3d hoặc image-to-3d. Tùy chọn; được suy luận từ các đầu vào khi bị bỏ qua.
Mô tả văn bản của mô hình 3D cần tạo, tối đa 2000 ký tự. Các mô hình có thể đặt giới hạn ngắn hơn; hãy xem chi tiết của chúng. Các yêu cầu image-to-3D cũng cần một prompt cho các mô hình hiện tại; nếu không có, yêu cầu sẽ trả về 400 prompt is required.
Hình ảnh được mã hóa Base64 cho việc tạo 3D từ hình ảnh.
URL công khai của hình ảnh cho việc tạo 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.
Cài đặt 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.
Cấu hình kiểu dáng (style preset) cho mô hình.
Số nguyên seed, khi được mô hình đã chọn hỗ trợ.
Định danh duy nhất cho người dùng cuối. Chỉ gửi trường này khi mô hình đã chọn chấp nhận nó.
Một số model cũng liệt kê n, negative_prompt và output_format (một bí danh của format). Chỉ gửi các tham số này khi chi tiết của model có liệt kê chúng.
Phản hồi (Response)
ID tác vụ để poll trạng thái.
Bí danh định danh tác vụ bất đồng bộ khi được trả về bởi adapter.
URL trạng thái cho tác vụ này. Hãy poll GET /v1/tasks/{id} với id.
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
Dấu thời gian Unix khi tác vụ được tạo.
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"
Khóa tùy chọn giúp yêu cầu tạo trở nên an toàn khi thử lại. Hãy gửi một giá trị duy nhất mới, chẳng hạn như UUID, cho mỗi tác vụ. Thử lại với cùng khóa và cùng phần thân sẽ trả về kết quả của yêu cầu tạo ban đầu, thường là tác vụ gốc, và không tạo, điều phối hoặc tính phí tác vụ thứ hai. Phần thân khác với khóa đã được chấp nhận sẽ bị từ chối với 409. Khóa dài hơn 255 ký tự sẽ bị bỏ qua và yêu cầu đó sẽ không có bảo vệ idempotency. Xem Thử lại an toàn với khóa idempotency.
1 <= length <= 255Nội dung yêu cầu
application/json
Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json