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"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"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",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
{
"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": {}
}Créer un World
Crée une tâche de génération de monde World Labs Marble
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"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"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",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
{
"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": {}
}poll_url pour vérifier l’état.
Choisissez un modèle Marble actuellement disponible via la Models API.
Corps de la requête
world_prompt pour les appels avancés. Les types pris en charge sont text, image, multi-image et video.world_prompt.type="multi-image" avec reconstruct_images: true et jusqu’à 8 images.true pour un panorama existant, false pour une image simple normale, ou auto.public, allow_id_access, allowed_readers et allowed_writers. public: true demande un monde visible publiquement.Réponse
pending, processing, completed ou failed.Tarification
Consultez la Pricing API pour les tarifs actuels. Le montant facturé figure dans vos relevés d’utilisation ; la valeurcost.total_credits renvoyée décrit l’utilisation de génération, pas un montant monétaire.
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"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"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",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
Autorisations
Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
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 en amont ou la création de ressources persistantes.
auto, verified, official Corps
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Objet world_prompt natif de World Labs pour les appelants avancés. Les types d'invites pris en charge sont text, image, multi-image et video. Les références de contenu peuvent utiliser source=media_asset avec un media_asset_id préparé par /v1/worlds/media-assets/prepare-upload.
Modèle Marble à utiliser. Par défaut marble-1.0 pour correspondre à la valeur par défaut de compatibilité World Labs actuelle lorsque le modèle est omis.
marble-1.0, marble-1.1, marble-1.1-plus Invite textuelle utilisée pour la génération de monde par texte ou par image/vidéo guidée.
Nom d'affichage optionnel pour le monde généré, jusqu'à 64 caractères.
64Invite d'image en Base64 ou URL de données.
Invite d'URL d'image.
Invites multi-images raccourcies. Fournissez jusqu'à 4 images. Utilisez world_prompt.reconstruct_images=true natif pour jusqu'à 8 images.
4Invite d'URL de vidéo.
Indique si une invite d'image est un panorama existant. Utilisez true pour une entrée pano, false pour une entrée image unique, ou auto.
Graine optionnelle de 0 à 4294967295.
0 <= x <= 4294967295Tags World Labs optionnels. Fournissez jusqu'à 10 tags, chacun jusqu'à 32 caractères.
1032Objet d'autorisation World Labs optionnel.
Identifiant de l'utilisateur final.