Passer au contenu principal
Générez des mondes 3D explorables avec World Labs Marble. Cette API est asynchrone : les réponses de création renvoient une identité de tâche et une poll_url pour vérifier l’état. Les modèles pris en charge sont marble-1.0, marble-1.1 et marble-1.1-plus. World Labs documente aussi marble-1.0-draft, mais TokenLab n’expose pas encore la génération draft sur cet endpoint.

​
Corps de la requête

​
model
string
défaut:"marble-1.0"
Modèle Marble à utiliser : marble-1.0, marble-1.1 ou marble-1.1-plus.
​
prompt
string
Prompt texte pour une génération texte seule ou comme guidage avec des entrées image/vidéo.
​
world_prompt
object
Objet World Labs natif world_prompt pour les appels avancés. Les types pris en charge sont text, image, multi-image et video.
​
image
string
Prompt image en Base64 ou data URL.
​
image_url
string
Prompt par URL d’image.
​
images
array
Plusieurs prompts image pour une génération multi-image simplifiée. Fournissez jusqu’à 4 images. Pour le mode reconstruction natif World Labs, passez world_prompt.type="multi-image" avec reconstruct_images: true et jusqu’à 8 images.
​
video_url
string
Prompt par URL vidéo.
​
is_pano
boolean | string
Pour les entrées image, définissez true pour un panorama existant, false pour une image simple normale, ou auto.
​
seed
integer
Seed optionnel de 0 à 4294967295.
​
display_name
string
Nom d’affichage optionnel pour le monde upstream, jusqu’à 64 caractères.
​
tags
array
Tags upstream optionnels. Jusqu’à 10 tags, 32 caractères maximum chacun.
​
permission
object
Objet permission World Labs optionnel.

​
Réponse

​
id
string
ID public de tâche pour le polling.
​
task_id
string
Alias de l’identifiant de tâche asynchrone.
​
operation_id
string
ID d’operation World Labs upstream.
​
poll_url
string
URL de polling recommandée pour cette tâche.
​
status
string
État de la tâche : pending, processing, completed ou failed.
​
world_marble_url
string
URL du monde Marble généré une fois terminé.
​
glb_url
string
URL GLB du maillage collider si disponible.
​
pano_url
string
URL de l’image panoramique si disponible.

​
Tarification

World Labs facture en credits. TokenLab pré-déduit le maximum du type de requête, puis règle selon cost.total_credits de l’operation terminée lorsqu’il est disponible. Les requêtes Marble standard vont jusqu’à 1 600 credits. marble-1.1-plus va jusqu’à 3 100 credits.

​
Périmètre

Ces endpoints de gestion couvrent les médias appartenant à TokenLab et les Worlds générés terminés. TokenLab n’expose toujours pas la génération marble-1.0-draft ni les outils pano/depth autonomes. 
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": "Une petite ville côtière calme au coucher du soleil, avec des ruelles étroites et des lumières chaudes"
  }'