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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası"
}'
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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası",
},
)
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: 'Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası'
})
});
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 Oluştur
World Labs Marble dünya üretim görevi oluşturur
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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası"
}'
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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası",
},
)
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: 'Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası'
})
});
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 döndürür.
Models API ile şu anda kullanılabilen bir Marble modeli seçin.
İstek Gövdesi
world_prompt nesnesi. Desteklenen prompt türleri text, image, multi-image ve video.world_prompt.type="multi-image", reconstruct_images: true ve en fazla 8 görüntü gönderin.true, normal tek görüntü için false ya da auto ayarlayın.public, allow_id_access, allowed_readers ve allowed_writers. public: true, herkese açık bir dünya oluşturulmasını ister.Yanıt
pending, processing, completed veya failed.Fiyatlandırma
Güncel fiyatlar için Pricing API kullanın. Faturalanan tutar kullanım kayıtlarında yer alır; döndürülencost.total_credits üretim kullanımını belirtir, para tutarını değil.
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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası"
}'
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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası",
},
)
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: 'Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
Yetkilendirmeler
API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, yukarı akış kabulü veya kalıcı kaynak oluşturma öncesinde yalnızca Official seçeneğine geçiş yapabilir.
auto, verified, official Gövde
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Gelişmiş kullanıcılar için yerel World Labs world_prompt nesnesi. Desteklenen istem türleri metin, görüntü, çoklu görüntü ve videodur. İçerik referansları, /v1/worlds/media-assets/prepare-upload ile hazırlanan bir media_asset_id ile source=media_asset kullanabilir.
Kullanılacak Marble modeli. Model belirtilmediğinde mevcut World Labs uyumluluk varsayılanıyla eşleşmesi için marble-1.0 varsayılan olarak kullanılır.
marble-1.0, marble-1.1, marble-1.1-plus Metin veya rehberli görüntü/video dünya oluşturma için kullanılan metin istemi.
Oluşturulan dünya için 64 karaktere kadar isteğe bağlı görünen ad.
64Base64 veya veri URL'si görüntü istemi.
Görüntü URL'si istemi.
Kısayol çoklu görüntü istemleri. 4 adede kadar görüntü sağlayın. 8 adede kadar görüntü için yerel world_prompt.reconstruct_images=true kullanın.
4Video URL'si istemi.
Görüntü isteminin mevcut bir panorama olup olmadığı. Pano girişi için true, tek görüntü girişi için false veya auto kullanın.
0 ile 4294967295 arasında isteğe bağlı tohum (seed).
0 <= x <= 4294967295İsteğe bağlı World Labs etiketleri. Her biri 32 karaktere kadar 10 adede kadar etiket sağlayın.
1032İsteğe bağlı World Labs izin nesnesi.
Son kullanıcı tanımlayıcısı.