Worlds

World を一覧

TokenLab で作成された完了済み World Labs Marble world を一覧します

POST
/v1/worlds/list

TokenLab で作成された完了済み World Labs Marble world を一覧します。結果は組織ごとに分離され、共有上流アカウント全体の一覧は公開されません。

保留中または失敗した生成タスクは /v1/worlds/generations/{id} を使用してください。この一覧は生成後に TokenLab が索引化した完了済み world だけを返します。

リクエストボディ

page_sizeintegerデフォルト: 20

返す world 数。1 から 100。

page_tokenstring

前回レスポンスのページネーショントークン。

statusstring

任意のフィルターは SUCCEEDED、PENDING、RUNNING、FAILED です。このエンドポイントは完了済みワールドを返し、後者 3 つでは空の一覧を返します。進捗は生成タスクで確認してください。

modelstring

任意の Marble モデルフィルター。

tagsarray

任意のタグフィルター。

is_publicboolean

任意の公開範囲フィルター。

created_afterstring

この時刻より後に作成された world のみ返します。

created_beforestring

この時刻より前に作成された world のみ返します。

sort_bystringデフォルト: created_at

created_at または updated_at で並べ替えます。

sort_orderstringデフォルト: desc

並び順: asc または desc。

レスポンス

worldsarray

World レコードの配列。

next_page_tokenstring | null

次ページのトークン、または null。

リクエスト

curl -X POST "https://api.tokenlab.sh/v1/worlds/list" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"}'
{  "worlds": [    {      "display_name": "string",      "world_id": "string",      "world_marble_url": "http://example.com",      "assets": {},      "created_at": "2019-08-24T14:15:22Z",      "model": "string",      "permission": {},      "tags": [        "string"      ],      "updated_at": "2019-08-24T14:15:22Z",      "world_prompt": {}    }  ],  "next_page_token": "string"}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

リクエストボディ

application/json

レスポンス

application/json

application/json