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"}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/list",
headers={"Authorization": "Bearer sk-your-api-key"},
json={"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"},
)
print(response.json()["worlds"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/list', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ page_size: 20, status: 'SUCCEEDED', model: 'marble-1.1' })
});
console.log((await response.json()).worlds);
{
"worlds": [
{
"world_id": "<string>",
"display_name": "<string>",
"world_marble_url": "<string>",
"assets": {},
"created_at": "2023-11-07T05:31:56Z",
"model": "<string>",
"permission": {},
"tags": [
"<string>"
],
"updated_at": "2023-11-07T05:31:56Z",
"world_prompt": {}
}
],
"next_page_token": "<string>"
}{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key"
}
}Worlds
World を一覧
TokenLab で作成された完了済み World Labs Marble world を一覧します
POST
/
v1
/
worlds
/
list
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"}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/list",
headers={"Authorization": "Bearer sk-your-api-key"},
json={"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"},
)
print(response.json()["worlds"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/list', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ page_size: 20, status: 'SUCCEEDED', model: 'marble-1.1' })
});
console.log((await response.json()).worlds);
{
"worlds": [
{
"world_id": "<string>",
"display_name": "<string>",
"world_marble_url": "<string>",
"assets": {},
"created_at": "2023-11-07T05:31:56Z",
"model": "<string>",
"permission": {},
"tags": [
"<string>"
],
"updated_at": "2023-11-07T05:31:56Z",
"world_prompt": {}
}
],
"next_page_token": "<string>"
}{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key"
}
}TokenLab で作成された完了済み World Labs Marble world を一覧します。結果は組織ごとに分離され、共有上流アカウント全体の一覧は公開されません。
保留中または失敗した生成タスクは
/v1/worlds/generations/{id} を使用してください。この一覧は生成後に TokenLab が索引化した完了済み world だけを返します。
リクエストボディ
integer
デフォルト:"20"
返す world 数。1 から 100。
string
前回レスポンスのページネーショントークン。
string
任意のフィルターは
SUCCEEDED、PENDING、RUNNING、FAILED です。このエンドポイントは完了済みワールドを返し、後者 3 つでは空の一覧を返します。進捗は生成タスクで確認してください。string
任意の Marble モデルフィルター。
array
任意のタグフィルター。
boolean
任意の公開範囲フィルター。
string
この時刻より後に作成された world のみ返します。
string
この時刻より前に作成された world のみ返します。
string
デフォルト:"created_at"
created_at または updated_at で並べ替えます。string
デフォルト:"desc"
並び順:
asc または desc。レスポンス
array
World レコードの配列。
string | 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"}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/list",
headers={"Authorization": "Bearer sk-your-api-key"},
json={"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"},
)
print(response.json()["worlds"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/list', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ page_size: 20, status: 'SUCCEEDED', model: 'marble-1.1' })
});
console.log((await response.json()).worlds);
承認
APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
ボディ
application/json
必須範囲:
1 <= x <= 100利用可能なオプション:
SUCCEEDED, PENDING, FAILED, RUNNING 利用可能なオプション:
marble-1.0, marble-1.1, marble-1.1-plus, marble-1.0-draft 利用可能なオプション:
created_at, updated_at 昇順または降順のためのTokenLab拡張機能。
利用可能なオプション:
asc, desc