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 seloncost.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érationmarble-1.0-draft ni les outils pano/depth autonomes.