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
Lister les Worlds
Liste les Worlds World Labs Marble terminés créés via TokenLab
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"
}
}Liste les World Labs Marble worlds terminés créés via TokenLab. Les résultats sont limités à votre organisation et n’incluent que les ressources créées via TokenLab.
Utilisez
/v1/worlds/generations/{id} pour les tâches en attente ou échouées. Cette liste renvoie uniquement les Worlds terminés que TokenLab a indexés après génération.
Corps de requête
integer
défaut:"20"
Nombre de worlds à renvoyer, de 1 à 100.
string
Token de pagination de la réponse précédente.
string
Filtre facultatif :
SUCCEEDED, PENDING, RUNNING ou FAILED. Ce point de terminaison liste les mondes terminés ; les trois autres valeurs renvoient une liste vide. Consultez la tâche de génération pour sa progression.string
Filtre optionnel sur le modèle Marble.
array
Filtre optionnel sur les tags.
boolean
Filtre optionnel de visibilité.
string
Ne renvoyer que les worlds créés après cet horodatage.
string
Ne renvoyer que les worlds créés avant cet horodatage.
string
défaut:"created_at"
Trier par
created_at ou updated_at.string
défaut:"desc"
Ordre de tri:
asc ou desc.Réponse
array
Tableau d’enregistrements world.
string | null
Token de page suivante, ou
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);
Autorisations
Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Corps
application/json
Plage requise:
1 <= x <= 100Options disponibles:
SUCCEEDED, PENDING, FAILED, RUNNING Options disponibles:
marble-1.0, marble-1.1, marble-1.1-plus, marble-1.0-draft Options disponibles:
created_at, updated_at Extension TokenLab pour l'ordre croissant ou décroissant.
Options disponibles:
asc, desc