Worlds

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 AssetsCopy Anchor Link

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.

Quyền truy cập bản ghi phương tiện và thế giới được kiểm tra theo tổ chức sở hữu khóa API. Trước khi chia sẻ, kiểm tra tùy chọn permission của mô hình; URL tài nguyên hoặc trình xem có thể có quy tắc truy cập riêng.

Tạo Và PollCopy Anchor Link

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/{id} đế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ấtCopy Anchor Link

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ặpCopy Anchor Link

• Đừ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 APICopy Anchor Link