poll_url للتحقق من الحالة.
النماذج المدعومة هي marble-1.0 و marble-1.1 و marble-1.1-plus. توثق World Labs النموذج marble-1.0-draft، لكن TokenLab لا يتيح draft generation في هذا endpoint حالياً.
جسم الطلب
string
افتراضي:"marble-1.0"
نموذج Marble المطلوب استخدامه:
marble-1.0 أو marble-1.1 أو marble-1.1-plus.string
موجه نصي للتوليد النصي فقط أو كإرشاد مع مدخلات الصور/الفيديو.
object
كائن World Labs أصلي باسم
world_prompt للمستخدمين المتقدمين. أنواع الموجهات المدعومة هي text و image و multi-image و video.string
موجه صورة بصيغة Base64 أو data URL.
string
موجه عبر URL صورة.
array
عدة موجهات صور لاختصار multi-image generation. يمكن إرسال حتى 4 صور. لوضع reconstruction mode الأصلي في World Labs، أرسل
world_prompt.type="multi-image" مع reconstruct_images: true وحتى 8 صور.string
موجه عبر URL فيديو.
boolean | string
لمدخلات الصور، استخدم
true لصورة بانورامية موجودة، أو false لصورة واحدة عادية، أو auto.integer
Seed اختياري من 0 إلى 4294967295.
string
اسم عرض اختياري للعالم المُنشأ، حتى 64 حرفاً.
array
وسوم World Labs اختيارية. حتى 10 وسوم، كل وسم حتى 32 حرفاً.
object
كائن permission اختياري من World Labs.
الاستجابة
string
معرف مهمة عام لاستخدامه في polling.
string
اسم بديل لمعرف المهمة غير المتزامنة.
string
معرّف العملية في World Labs.
string
رابط polling المفضل لهذه المهمة.
string
حالة المهمة:
pending أو processing أو completed أو failed.string
رابط عالم Marble الناتج عند الاكتمال.
string
رابط GLB لشبكة collider عند توفره.
string
رابط صورة بانورامية عند توفرها.
التسعير
تحاسب World Labs باستخدام credits. يخصم TokenLab الحد الأقصى لنوع الطلب مسبقاً، ثم يسوي حسبcost.total_credits من operation المكتملة عند توفرها. طلبات Marble القياسية تصل إلى 1,600 credits. طلبات marble-1.1-plus تصل إلى 3,100 credits.
النطاق
تغطي نقاط الإدارة هذه أصول الوسائط المملوكة لـ TokenLab والعوالم المكتملة. لا يتيح TokenLab بعد إنشاءmarble-1.0-draft أو أدوات pano/depth المستقلة.