TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

Worlds

إنشاء World

ينشئ مهمة توليد عالم باستخدام World Labs Marble

POST
/v1/worlds/generations

أنشئ عوالم ثلاثية الأبعاد قابلة للاستكشاف باستخدام World Labs Marble. هذا API غير متزامن: تعيد استجابة الإنشاء هوية المهمة و poll_url للتحقق من الحالة.

اختر نموذج Marble متاحًا حاليًا عبر Models API.

جسم الطلب

modelstringالافتراضي: marble-1.0

اختر نموذج Marble متاحًا حاليًا عبر Models API.

promptstring

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

world_promptobject

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

imagestring

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

image_urlstring

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

imagesarray

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

video_urlstring

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

is_panoboolean | string

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

seedinteger

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

display_namestring

اسم عرض اختياري للعالم المُنشأ، حتى 64 حرفاً.

tagsarray

وسوم World Labs اختيارية. حتى 10 وسوم، كل وسم حتى 32 حرفاً.

permissionobject

إعدادات اختيارية للرؤية والوصول: public و allow_id_access و allowed_readers و allowed_writers. تطلب public: true إنشاء عالم مرئي للعامة.

الاستجابة

idstring

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

task_idstring

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

operation_idstring

معرّف العملية في World Labs.

poll_urlstring

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

statusstring

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

world_marble_urlstring

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

glb_urlstring

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

pano_urlstring

رابط صورة بانورامية عند توفرها.

التسعير

راجع Pricing API للأسعار الحالية. يظهر المبلغ المفوتر في سجلات الاستخدام؛ وقيمة cost.total_credits المعادة تصف استخدام التوليد، وليست مبلغًا نقديًا.

الطلب

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

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

جلب أصل وسائط

السابق

الحصول على حالة العالم

التالي