Chuyển đến nội dung chính
Tạo World tạo Marble Worlds có thể khám phá theo cách bất đồng bộ. Dùng Worlds khi đầu ra là môi trường người dùng có thể mở hoặc quay lại. Dùng tạo 3D khi bạn cần một asset mô hình độc lập.

​
Đầu Vào Và Media Assets

Tác vụ World có thể bắt đầu từ văn bản, hình ảnh, nhiều hình ảnh hoặc video tùy theo model đã chọn và dạng yêu cầu. Với prompt media tái sử dụng, hãy chuẩn bị media asset trước rồi tham chiếu trong yêu cầu World. Media assets và Worlds đã hoàn tất chỉ khả dụng cho tài khoản của bạn.

​
Tạo Và Poll

Phản hồi tạo gồm ID tác vụ công khai và thường có poll_url. Lưu ID đó trước khi hiển thị tiến trình, rồi theo poll_url hoặc GET /v1/tasks/ đến khi tác vụ completed hoặc failed. 
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "marble-1.1",
    "prompt": "A quiet coastal town at sunset with narrow alleys and warm lights"
  }'

​
Quản Lý Worlds Đã Hoàn Tất

Dùng endpoint liệt kê và lấy Worlds cho Worlds đã hoàn tất trong tài khoản của bạn. Dùng endpoint trạng thái tác vụ cho tác vụ đang chờ hoặc thất bại. Chỉ xóa khi người dùng chủ động gỡ World đã tạo khỏi sản phẩm của bạn.

​
Lỗi Thường Gặp

  • Đừng giả định mọi World model đều hỗ trợ mọi loại đầu vào.
  • Giữ URL ảnh hoặc video đã ký đủ lâu cho các lần dịch vụ thử tải lại.
  • Lưu ID tác vụ trả về trước khi thử lại sau timeout.
  • Dùng tạo 3D cho tệp mô hình có thể tải xuống thay vì Worlds có thể khám phá.

​
Tham Chiếu API

Chủ đềTham chiếu
Tạo WorldTạo World
Lấy Trạng Thái WorldLấy Trạng Thái World
Chuẩn Bị Tải Media AssetChuẩn Bị Tải Media Asset
Lấy Media AssetLấy Media Asset
Liệt Kê WorldsLiệt Kê Worlds
Lấy WorldLấy World
Xóa WorldXóa World
Tác Vụ Bất Đồng BộTác Vụ Bất Đồng Bộ
Hướng Dẫn Tạo 3DHướng Dẫn Tạo 3D