Worlds

Dünya Oluştur

Bir World Labs Marble dünya üretim görevi oluşturur

POST
/v1/worlds/generations

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

modelstringvarsayılan: marble-1.0

Models API aracılığıyla şu anda kullanılabilir olan bir Marble modeli seçin.

promptstring

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.

world_promptobject

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": "..." }.

imagestring

Base64 veya data URL görsel prompt'u.

image_urlstring

Görsel URL'si prompt'u.

imagesarray

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_urlstring

Video URL'si prompt'u.

is_panoboolean | string

Görsel girdileri için mevcut bir panorama ise true, normal tekil görsel ise false veya auto olarak ayarlayın.

seedinteger

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

display_namestring

Üretilen dünya için en fazla 64 karakter uzunluğunda isteğe bağlı görünen ad.

tagsarray

İsteğe bağlı World Labs etiketleri. Her biri en fazla 32 karakter olmak üzere en fazla 10 etiket sağlayın.

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 olarak görülebilen bir dünya talep eder.

Yanıt

idstring

Genel görev kimliği (ID). Durumu sorgulamak için bu değerle GET /v1/tasks/{id} uç noktasını yoklayın.

task_idstring

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

operation_idstring

World Labs operasyon kimliği (ID).

poll_urlstring

/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.

statusstring

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

world_marble_urlstring

Tamamlandığında üretilen Marble dünyasının URL'si.

glb_urlstring

Kullanılabilir olduğunda collider mesh GLB URL'si.

pano_urlstring

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. param ilgili alanı belirtir.
  • 400 model_not_found veya unsupported_endpoint: Model, çağrılabilir bir Marble modeli değil.
  • 403 media_asset_not_owned veya 404 media_asset_not_found: world_prompt içindeki bir media_asset_id baş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
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"
Idempotency-Key?string

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.

Uzunluk1 <= length <= 255

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json