Skip to main content
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

string
défaut:"marble-1.0"
Modèle Marble à utiliser : marble-1.0, marble-1.1 ou marble-1.1-plus.
string
Prompt texte pour une génération texte seule ou comme guidage avec des entrées image/vidéo.
object
Objet World Labs natif world_prompt pour les appels avancés. Les types pris en charge sont text, image, multi-image et video.
string
Prompt image en Base64 ou data URL.
string
Prompt par URL d’image.
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.
string
Prompt par URL vidéo.
boolean | string
Pour les entrées image, définissez true pour un panorama existant, false pour une image simple normale, ou auto.
integer
Seed optionnel de 0 à 4294967295.
string
Nom d’affichage optionnel pour le monde généré, jusqu’à 64 caractères.
array
Tags World Labs optionnels. Jusqu’à 10 tags, 32 caractères maximum chacun.
object
Objet permission World Labs optionnel.

Réponse

string
ID public de tâche pour le polling.
string
Alias de l’identifiant de tâche asynchrone.
string
ID de l’opération World Labs.
string
URL de polling recommandée pour cette tâche.
string
État de la tâche : pending, processing, completed ou failed.
string
URL du monde Marble généré une fois terminé.
string
URL GLB du maillage collider si disponible.
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.