World Oluştur

World Labs Marble ile keşfedilebilir 3D dünyalar oluşturun. Bu API asenkrondur: oluşturma yanıtları bir görev kimliği ve durum kontrolleri için poll_url döndürür.

Models API ile şu anda kullanılabilen bir Marble modeli seçin.

İstek Gövdesi

modelstringvarsayılan: marble-1.0

Models API ile şu anda kullanılabilen bir Marble modeli seçin.

promptstring

Yalnızca metin üretimi için ya da görüntü/video girişleriyle rehber olarak kullanılacak metin promptu.

world_promptobject

Gelişmiş çağrılar için native World Labs world_prompt nesnesi. Desteklenen prompt türleri text, image, multi-image ve video.

imagestring

Base64 veya data URL görüntü promptu.

image_urlstring

Görüntü URL promptu.

imagesarray

Kısa yoldan multi-image generation için birden çok görüntü promptu. En fazla 4 görüntü sağlayın. Native World Labs reconstruction mode için world_prompt.type="multi-image", reconstruct_images: true ve en fazla 8 görüntü gönderin.

video_urlstring

Video URL promptu.

is_panoboolean | string

Görüntü girişlerinde mevcut panorama için true, normal tek görüntü için false ya da auto ayarlayın.

seedinteger

0 ile 4294967295 arasında isteğe bağlı seed.

display_namestring

Upstream dünya için isteğe bağlı görünen ad, en fazla 64 karakter.

tagsarray

İsteğe bağlı World Labs etiketleri. En fazla 10 etiket, her biri en fazla 32 karakter.

permissionobject

İsteğe bağlı görünürlük ve erişim ayarları: public, allow_id_access, allowed_readers ve allowed_writers. public: true, herkese açık bir dünya oluşturulmasını ister.

Yanıt

idstring

Polling için genel görev IDsi.

task_idstring

Asenkron görev tanımlayıcı aliası.

operation_idstring

World Labs işlem kimliği.

poll_urlstring

Bu görev için tercih edilen polling URLsi.

statusstring

Görev durumu: pending, processing, completed veya failed.

world_marble_urlstring

Tamamlandığında oluşturulan Marble dünya URLsi.

glb_urlstring

Varsa collider mesh GLB URLsi.

pano_urlstring

Varsa panorama görüntü URLsi.

Fiyatlandırma

Güncel fiyatlar için Pricing API kullanın. Faturalanan tutar kullanım kayıtlarında yer alır; döndürülen cost.total_credits üretim kullanımını belirtir, para tutarını değil.

İstek

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ı"
  }'

{  "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"    }  }}

Yetkilendirme

BearerAuth

AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İ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ı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

"auto"
"verified"
"official"

İstek gövdesi

application/json

model?string

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.

varsayılan"marble-1.0"

Geçerli değerler

"marble-1.0"
"marble-1.1"
"marble-1.1-plus"

prompt?string

Metin veya rehberli görüntü/video dünya oluşturma için kullanılan metin istemi.

display_name?string

Oluşturulan dünya için 64 karaktere kadar isteğe bağlı görünen ad.

Uzunluklength <= 64

world_prompt*

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.

image?string

Base64 veya veri URL'si görüntü istemi.

image_url?string

Görüntü URL'si istemi.

Biçimuri

images?array<string|>

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.

Öğeleritems <= 4

video_url?string

Video URL'si istemi.

Biçimuri

is_pano?|

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.

seed?integer

0 ile 4294967295 arasında isteğe bağlı tohum (seed).

Aralık0 <= value <= 4294967295

tags?array<>

İsteğe bağlı World Labs etiketleri. Her biri 32 karaktere kadar 10 adede kadar etiket sağlayın.

Öğeleritems <= 10

permission?

İsteğe bağlı World Labs izin nesnesi.

user?string

Son kullanıcı tanımlayıcısı.

World Oluştur

İstek Gövdesi

Yanıt

Fiyatlandırma

Yetkilendirme

Başlıklar

İstek gövdesi

Yanıt

`application/json`

`application/json`

`application/json`

World Oluştur

İstek GövdesiCopy Anchor Link

YanıtCopy Anchor Link

FiyatlandırmaCopy Anchor Link

YetkilendirmeCopy Anchor Link

BaşlıklarCopy Anchor Link

İstek gövdesiCopy Anchor Link

YanıtCopy Anchor Link

200application/json

401application/json

503application/json

İstek Gövdesi

Yanıt

Fiyatlandırma

Yetkilendirme

Başlıklar

İstek gövdesi

Yanıt

`application/json`

`application/json`

`application/json`