Tripo: 3D Generation

Tripo tạo sản phẩm mô hình 3D từ mô tả đối tượng bằng văn bản. Các quy trình rộng hơn của nhà sản xuất phân biệt hình học, tạo kết cấu bề mặt và xử lý mô hình về sau; kiểm tra lưới hoàn chỉnh từ nhiều góc nhìn và giữ các tệp thực tế cho cảnh hoặc trình biên tập đích.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

Tripo tạo sản phẩm mô hình 3D từ mô tả hoặc ảnh tham chiếu. Các quy trình tách việc tạo đối tượng khỏi những bước sau như tạo kết cấu bề mặt, gắn bộ xương và chuyển đổi. Bắt đầu bằng việc xác định sản phẩm dự kiến và thao tác tạo ra nó: lưới tĩnh cho cảnh, đối tượng có kết cấu bề mặt để kết xuất hoặc mô hình sẽ tiếp tục được chuẩn bị trong trình biên tập 3D.

Với yêu cầu tạo mô hình từ văn bản, mô tả hình dạng và các bộ phận quan trọng của đối tượng. Có thể mô tả đèn lồng nhỏ qua thân, tay cầm, các lỗ mở và tỷ lệ; sinh vật qua dáng tổng thể, các chi và tư thế. Nêu vật liệu hoặc cách xử lý hình thức khi chúng ảnh hưởng đến kết quả. Giữ mô tả tập trung vào chính đối tượng để đánh giá hình học được tạo theo một thiết kế rõ ràng.

Với quy trình dựa trên ảnh tham chiếu của nhà sản xuất, chuẩn bị ảnh thể hiện đường bao và đặc điểm nhận diện của chủ thể. Nhiều góc nhìn cần mô tả cùng một đối tượng với tỷ lệ và phụ kiện nhất quán. Kiểm tra những phần bị khuất trong ảnh tham chiếu sau khi tạo, vì mặt trước thuyết phục không xác lập mặt sau, mặt dưới hay các mối nối giữa bộ phận đã khớp thiết kế dự kiến.

Giữ phiên bản mô hình đã chọn cùng yêu cầu. Giao diện tạo của Tripo xác định thao tác tách biệt với thiết lập phiên bản mô hình, và ví dụ tạo mô hình từ văn bản trong tài liệu chọn phiên bản cụ thể. Giữ chính xác phiên bản và các thiết lập khi so sánh sản phẩm để không nhầm thay đổi mô tả đối tượng với thay đổi cấu hình tạo.

Hình học và diện mạo bề mặt là các quyết định sản xuất riêng. Quy trình cơ sở của nhà sản xuất phân biệt mô hình chưa có kết cấu bề mặt với đầu ra có kết cấu và vật liệu kết xuất dựa trên vật lý. Chọn dạng sản phẩm cần cho bước tiếp theo, rồi kiểm tra cả lưới và các tệp vật liệu đi kèm. Ảnh xem trước hữu ích để định hướng, còn mô hình thực tế là sản phẩm cần để lắp ráp cảnh và chỉnh sửa tiếp.

Xem xét đối tượng hoàn chỉnh từ nhiều góc. Kiểm tra dáng tổng thể, sự tách biệt giữa các bộ phận, chi tiết mảnh, các lỗ mở và bề mặt nơi thành phần tiếp giáp. Với đạo cụ cách điệu, so sánh tỷ lệ với yêu cầu thiết kế. Với đối tượng dạng sản phẩm, kiểm tra chi tiết nào được thể hiện bằng hình học và chi tiết nào chỉ xuất hiện qua xử lý bề mặt. Xác định đặc điểm cần sửa trước khi đổi prompt hoặc ảnh tham chiếu.

Quá trình tạo chạy dưới dạng tác vụ bất đồng bộ. Giữ thông tin định danh tác vụ gốc trong suốt quá trình kiểm tra trạng thái và lưu mô hình hoàn chỉnh, ảnh xem trước cùng mọi tệp trả về khác với nhau. Kết quả được tài liệu hóa gồm các trường đầu ra liên quan đến mô hình và hình ảnh đã kết xuất. Lưu chính các tệp cho bước sản xuất tiếp theo, thay vì dựa vào liên kết kết quả tạm thời hoặc coi ảnh xem trước là sản phẩm 3D đầy đủ.

Nhập mô hình vào trình biên tập hoặc môi trường xem dự kiến và kiểm tra hướng, tỷ lệ, vật liệu, hình học tại đó. Đạo cụ cảnh, ảnh kết xuất cận cảnh và nhân vật sẵn sàng cho hoạt hình có nhu cầu hoàn thiện khác nhau. Giữ bản làm việc để chỉnh sửa và bảo toàn sản phẩm nguồn được tạo cùng yêu cầu và tài liệu tham chiếu. Khi cần thao tác khác như xử lý kết cấu bề mặt hoặc gắn bộ xương, chủ động chọn thao tác đó và xem xét sản phẩm thu được như một giai đoạn riêng.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

tripo3d

Tripo /tripo3d

Bắt đầu

Đầu vào được chấp nhận: Văn bản
Kết quả: model_3d · Ảnh

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · 3D POST /v1/3d/generations

Đầu vào: text
Đầu ra: model_3d, image

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn tripo3d Điều kiện: Dùng bộ chọn mô hình Ailoot.	Mặc định—
Trường`type`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Điều kiện: Ví dụ đầy đủ dùng text_to_model; các loại tác vụ khác yêu cầu đầu vào riêng được tài liệu quy định cho từng tác vụ.	Mặc định—
Trường`model_version`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Điều kiện: Chọn phiên bản được tài liệu quy định rõ ràng; ví dụ này dùng v3.0-20250812.	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện: Mô tả đối tượng cần tạo.	Mặc định—

Tham số phương thức và vòng đời

Tham số	Hợp đồng
Tham số`content_type`	Hợp đồngapplication/json
Tham số`required`	Hợp đồngmodel, type, model_version, prompt
Tham số`optional`	Hợp đồng
Tham số`material_types`	Hợp đồngtext
Tham số`conditions`	Hợp đồngDùng bộ chọn mô hình Ailoot., Ví dụ đầy đủ dùng text_to_model; các loại tác vụ khác yêu cầu đầu vào riêng được tài liệu quy định cho từng tác vụ., Chọn phiên bản được tài liệu quy định rõ ràng; ví dụ này dùng v3.0-20250812., Mô tả đối tượng cần tạo.

Vòng đời: submit_once_poll_original

GET /v1/3d/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Bảng giá

Cách tính phí cuối cùng

Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh: Chưa chỉ định Khi chọn chế độ nhanh
Chế độ Flex: Chưa chỉ định Khi chọn chế độ flex
Mức độ suy luận tối đa: Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Mức phí ước tính để so sánh

Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

Cấu hình	Biểu mức phí	Số lượng dự báo	Phí
Cấu hìnhGiá cơ sở cho token	Biểu mức phíMức phí cơ bản	Số lượng dự báo—	Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token
Cấu hìnhChi phí tạo ước tính	Biểu mức phí—	Số lượng dự báoước tính cho một lần tạo	Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $1.35 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất.

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →

Ví dụ yêu cầu

Ailoot Ultra · 3D

curl · chỉ tạo một lần và giữ lại biên nhậnĐọc tác vụ gốcLưu từng tài nguyên đã hoàn tất thuộc quyền sở hữu của bạn

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "tripo3d",
  "type": "text_to_model",
  "prompt": "a cute pig",
  "model_version": "v3.0-20250812"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/3d/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Nhận và lưu kết quả

Ailoot Ultra · 3D

Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh

GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lưu tất cả kết quả đã hoàn tất

Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.

Giữ lại toàn bộ phản hồi và tiêu đề, các mã định danh gốc, mọi đầu ra thực tế và tất cả trường mức sử dụng/hạch toán. Lưu từng tài sản duy nhất thuộc quyền sở hữu và giữ lại mọi vai trò tham chiếu đến tài sản đó.

Nếu cần kiểm tra phản hồi gốc

Giữ lại id tác vụ hoặc thao tác công khai được trả về và tất cả tiêu đề. Chỉ đọc tác vụ ban đầu; unknown hoặc result_pending_check không cho phép tạo thêm tác vụ.

Trường phản hồi

Trường	Loại
Trường`id`	Loạistring
Trường`polling_url`	Loạistring
Trường`provider_task_id`	Loạistring
Trường`code`	Loạiinteger
Trường`data.task_id`	Loạistring
Trường`data.status`	Loạistring
Trường`data.progress`	Loạiinteger
Trường`data.output.*`	Loạistring
Trường`data.result.*.url`	Loạistring
Trường`data.result.*.type`	Loạistring
Trường`data.thumbnail`	Loạistring

Bí danh

Bí danh mô hình

Ailoot Ultra tripo3d

Bí danh đường dẫn phương thức

Dùng các đường dẫn phương thức hiển thị ở trên.

ID gọi liên quan

tripo3d

FAQ · Tripo: 3D Generation

Có những đầu vào và kết quả nào?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Yêu cầu sử dụng những trường nào?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation