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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht"
}'
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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht",
},
)
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: 'Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht'
})
});
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": {}
}World erstellen
Erstellt eine World Labs Marble-Weltgenerierungsaufgabe
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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht"
}'
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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht",
},
)
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: 'Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht'
})
});
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 für Statusabfragen zurück.
Wählen Sie ein aktuell verfügbares Marble-Modell über die Models API.
Request-Body
world_prompt-Objekt für fortgeschrittene Aufrufer. Unterstützte Prompt-Typen sind text, image, multi-image und video.world_prompt.type="multi-image" mit reconstruct_images: true und bis zu 8 Bilder.true für ein vorhandenes Panorama, false für ein normales Einzelbild oder auto.public, allow_id_access, allowed_readers und allowed_writers. public: true fordert eine öffentlich sichtbare Welt an.Antwort
pending, processing, completed oder failed.Preise
Aktuelle Preise finden Sie in der Pricing API. Der endgültige Rechnungsbetrag steht in Ihren Nutzungsdaten. Ein zurückgegebenescost.total_credits beschreibt Generierungsverbrauch, keinen Währungsbetrag.
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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht"
}'
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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht",
},
)
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: 'Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
Autorisierungen
API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Header
Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Upstream-Akzeptanz oder der Erstellung persistenter Ressourcen einmalig auf Official wechseln.
auto, verified, official Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Natives World Labs world_prompt-Objekt für fortgeschrittene Aufrufer. Unterstützte Prompt-Typen sind text, image, multi-image und video. Inhaltsreferenzen können source=media_asset mit einer media_asset_id verwenden, die über /v1/worlds/media-assets/prepare-upload vorbereitet wurde.
Zu verwendendes Marble-Modell. Standardmäßig marble-1.0, um dem aktuellen World Labs-Kompatibilitätsstandard zu entsprechen, wenn das Modell weggelassen wird.
marble-1.0, marble-1.1, marble-1.1-plus Text-Prompt für textbasierte oder geführte Bild-/Video-World-Generation.
Optionaler Anzeigename für die generierte Welt, bis zu 64 Zeichen.
64Base64- oder Daten-URL-Bild-Prompt.
Bild-URL-Prompt.
Shortcut für Multi-Image-Prompts. Geben Sie bis zu 4 Bilder an. Verwenden Sie native world_prompt.reconstruct_images=true für bis zu 8 Bilder.
4Video-URL-Prompt.
Ob ein Bild-Prompt ein existierendes Panorama ist. Verwenden Sie true für Pano-Input, false für Einzelbild-Input oder auto.
Optionaler Seed von 0 bis 4294967295.
0 <= x <= 4294967295Optionale World Labs-Tags. Geben Sie bis zu 10 Tags an, jeweils bis zu 32 Zeichen.
1032Optionales World Labs-Berechtigungsobjekt.
Endbenutzer-Identifikator.