Worlds
Créer un World
Crée une tâche de génération de monde World Labs Marble
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.
Choisissez un modèle Marble actuellement disponible via la Models API.
Corps de la requête
marble-1.0Choisissez un modèle Marble actuellement disponible via la Models API.
Prompt texte pour une génération texte seule ou comme guidage avec des entrées image/vidéo.
Objet World Labs natif world_prompt pour les appels avancés. Les types pris en charge sont text, image, multi-image et video.
Prompt image en Base64 ou data URL.
Prompt par URL d’image.
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.
Prompt par URL vidéo.
Pour les entrées image, définissez true pour un panorama existant, false pour une image simple normale, ou auto.
Seed optionnel de 0 à 4294967295.
Nom d’affichage optionnel pour le monde généré, jusqu’à 64 caractères.
Tags World Labs optionnels. Jusqu’à 10 tags, 32 caractères maximum chacun.
Paramètres facultatifs de visibilité et d’accès : public, allow_id_access, allowed_readers et allowed_writers. public: true demande un monde visible publiquement.
Réponse
ID public de tâche pour le polling.
Alias de l’identifiant de tâche asynchrone.
ID de l’opération World Labs.
URL de polling recommandée pour cette tâche.
État de la tâche : pending, processing, completed ou failed.
URL du monde Marble généré une fois terminé.
URL GLB du maillage collider si disponible.
URL de l’image panoramique si disponible.
Tarification
Consultez la Pricing API pour les tarifs actuels. Le montant facturé figure dans vos relevés d’utilisation ; la valeur cost.total_credits renvoyée décrit l’utilisation de génération, pas un montant monétaire.
Requête
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"
}'{ "id": "string", "task_id": "string", "operation_id": "string", "status": "pending", "poll_url": "string", "world_id": "string", "world_marble_url": "string", "model_url": "string", "glb_url": "string", "pano_url": "string", "thumbnail_url": "string", "caption": "string", "cost": {}, "error": "string", "error_details": { "projection_version": 0, "status": 400, "message": "string", "type": "string", "code": "string", "param": "string", "retryable": true, "upstream": { "source": "string", "code": "string", "message": "string", "param": "string" } }}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Corps de la requête
application/json
Réponse
application/json
application/json
application/json