Worlds
Dünya Oluştur
Bir World Labs Marble dünya üretim görevi oluşturur
World Labs Marble ile keşfedilebilir 3D dünyalar üretin. Bu asenkron bir API'dir: oluşturma yanıtları bir görev kimliği döndürür. Durum bilgisi için görevin id değeriyle GET /v1/tasks/{id} uç noktasını yoklayın.
Models API aracılığıyla şu anda kullanılabilir olan bir Marble modeli seçin.
İstek Gövdesi
marble-1.0Models API aracılığıyla şu anda kullanılabilir olan bir Marble modeli seçin.
Yalnızca metin ile üretim için metin prompt'u veya görsel ve video girdileri için yönlendirme. En fazla 4000 karakter. world_prompt, prompt, image, image_url, images veya video_url parametrelerinden en az birini gönderin.
Gelişmiş çağrılar için yerel World Labs world_prompt nesnesi. Desteklenen prompt türleri: text, image, multi-image ve video. İçerik referansı, Medya Varlığı Yüklemesini Hazırla ile yüklediğiniz bir dosyayı işaret edebilir: { "source": "media_asset", "media_asset_id": "..." }.
Base64 veya data URL görsel prompt'u.
Görsel URL'si prompt'u.
Kestirme çoklu görsel üretimi için birden fazla görsel prompt'u. Her biri bir URL, Base64 veya data URL dizesi ya da uri, image_url veya url ile isteğe bağlı bir azimuth sayısı içeren bir nesne olmak üzere en fazla 4 görsel sağlayın. Yerel World Labs yeniden yapılandırma modu için, reconstruct_images: true ve en fazla 8 görsel ile world_prompt.type="multi-image" değerini iletin.
Video URL'si prompt'u.
Görsel girdileri için mevcut bir panorama ise true, normal tekil görsel ise false veya auto olarak ayarlayın.
0 ile 4294967295 arasında isteğe bağlı seed değeri.
Üretilen dünya için en fazla 64 karakter uzunluğunda isteğe bağlı görünen ad.
İsteğe bağlı World Labs etiketleri. Her biri en fazla 32 karakter olmak üzere en fazla 10 etiket sağlayın.
İ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 olarak görülebilen bir dünya talep eder.
Yanıt
Genel görev kimliği (ID). Durumu sorgulamak için bu değerle GET /v1/tasks/{id} uç noktasını yoklayın.
Asenkron görev tanımlayıcı rumuzu.
World Labs operasyon kimliği (ID).
/v1/worlds/generations/{id} altındaki dünya durum URL'si. Bu bir uyumluluk uç noktasıdır. Bunun yerine id ile GET /v1/tasks/{id} uç noktasını yoklayın.
Görev durumu: pending, processing, completed veya failed.
Tamamlandığında üretilen Marble dünyasının URL'si.
Kullanılabilir olduğunda collider mesh GLB URL'si.
Kullanılabilir olduğunda panorama görseli URL'si.
Fiyatlandırma
Güncel ücretler için Pricing API sayfasına bakın. Nihai faturalandırılan tutar kullanım kayıtlarınızda gösterilir.
Hatalar
400 invalid_request: Hiçbir prompt girdisi gönderilmedi veya bir alan geçerli aralığın dışında.paramilgili alanı belirtir.400 model_not_foundveyaunsupported_endpoint: Model, çağrılabilir bir Marble modeli değil.403 media_asset_not_ownedveya404 media_asset_not_found:world_promptiçindeki birmedia_asset_idbaşka bir Workspace'e ait veya mevcut değil.402: Bakiye, görevi başlatmak için çok düşük.
İ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": "A quiet coastal town at sunset with narrow alleys and warm lights"
}'{ "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", "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 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
İ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"
Oluşturma isteğinin güvenli bir şekilde yeniden denenmesini sağlayan isteğe bağlı anahtar. Her görev için UUID gibi yeni ve benzersiz bir değer gönderin. Aynı anahtar ve aynı gövde ile yapılan bir yeniden deneme, orijinal oluşturma isteğinin sonucunu (genellikle orijinal görevi) döndürür ve ikinci bir görev oluşturmaz, göndermez veya ücretlendirmez. Daha önce kabul edilmiş bir anahtara sahip farklı bir gövde, 409 hatası ile reddedilir. 255 karakterden uzun bir anahtar yok sayılır ve bu durumda isteğin idempotency koruması olmaz. Bkz: Idempotency anahtarı ile güvenli yeniden deneme.
1 <= length <= 255İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json