إنشاء World - TokenLab

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": "بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة"
  }'

أنشئ عوالم ثلاثية الأبعاد قابلة للاستكشاف باستخدام World Labs Marble. هذا API غير متزامن: تعيد استجابة الإنشاء هوية المهمة و poll_url للتحقق من الحالة. النماذج المدعومة هي marble-1.0 و marble-1.1 و marble-1.1-plus. توثق World Labs النموذج marble-1.0-draft، لكن TokenLab لا يتيح draft generation في هذا endpoint حالياً.

جسم الطلب

model

string

افتراضي:"marble-1.0"

نموذج Marble المطلوب استخدامه: marble-1.0 أو marble-1.1 أو marble-1.1-plus.

prompt

string

موجه نصي للتوليد النصي فقط أو كإرشاد مع مدخلات الصور/الفيديو.

world_prompt

object

كائن World Labs أصلي باسم world_prompt للمستخدمين المتقدمين. أنواع الموجهات المدعومة هي text و image و multi-image و video.

image

string

موجه صورة بصيغة Base64 أو data URL.

image_url

string

موجه عبر URL صورة.

images

array

عدة موجهات صور لاختصار multi-image generation. يمكن إرسال حتى 4 صور. لوضع reconstruction mode الأصلي في World Labs، أرسل world_prompt.type="multi-image" مع reconstruct_images: true وحتى 8 صور.

video_url

string

موجه عبر URL فيديو.

is_pano

boolean | string

لمدخلات الصور، استخدم true لصورة بانورامية موجودة، أو false لصورة واحدة عادية، أو auto.

seed

integer

Seed اختياري من 0 إلى 4294967295.

display_name

string

اسم عرض اختياري للعالم upstream، حتى 64 حرفاً.

الاستجابة

string

معرف مهمة عام لاستخدامه في polling.

task_id

string

اسم بديل لمعرف المهمة غير المتزامنة.

operation_id

string

معرف operation في World Labs upstream.

poll_url

string

رابط polling المفضل لهذه المهمة.

status

string

حالة المهمة: pending أو processing أو completed أو failed.

world_marble_url

string

رابط عالم Marble الناتج عند الاكتمال.

glb_url

string

رابط GLB لشبكة collider عند توفره.

pano_url

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 المستقلة.

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": "بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة"
  }'

جلب أصل وسائط الحصول على حالة World

​جسم الطلب

​الاستجابة

​التسعير

​النطاق

جسم الطلب

الاستجابة

التسعير

النطاق