Chuyển đến nội dung chính
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.

​
Nội dung yêu cầu

​
model
string
mặc định:"tripo3d-v2.5"
Model để sử dụng (ví dụ: tripo3d-v2.5, tripo3d-v2).
​
prompt
string
bắt buộc
Mô tả văn bản của mô hình 3D cần tạo.
​
image
string
Hình ảnh được mã hóa Base64 để tạo mô hình 3D từ hình ảnh.
​
image_url
string
URL của hình ảnh để tạo mô hình 3D từ hình ảnh.
​
format
string
mặc định:"glb"
Định dạng đầu ra: glb, fbx, obj, hoặc usdz.
​
quality
string
mặc định:"standard"
Mức chất lượng: draft, standard, hoặc high.
​
style
string
Phong cách thiết lập sẵn cho mô hình.
​
seed
integer
Seed để tạo kết quả có thể tái lập.
​
user
string
Một mã định danh duy nhất cho người dùng cuối.

​
Phản hồi

​
id
string
ID tác vụ để kiểm tra trạng thái (polling).
​
task_id
string
Bí danh của mã tác vụ bất đồng bộ khi được adapter trả về.
​
poll_url
string
URL polling ưu tiên khi có sẵn.
​
status
string
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
​
created
integer
Dấu thời gian Unix của thời điểm tạo tác vụ.
curl -X POST "https://api.aisonar.dev/v1/3d/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "A detailed medieval castle with towers",
    "format": "glb",
    "quality": "high"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo3d-v2.5"
}