إنشاء World

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

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/worlds/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "marble-1.1",
        "prompt": "بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة",
    },
)

task = response.json()
print(task["id"], task["poll_url"])

const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'marble-1.1',
    prompt: 'بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة'
  })
});

const task = await response.json();
console.log(task.id, task.poll_url);

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

POST

worlds

generations

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

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/worlds/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "marble-1.1",
        "prompt": "بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة",
    },
)

task = response.json()
print(task["id"], task["poll_url"])

const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'marble-1.1',
    prompt: 'بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة'
  })
});

const task = await response.json();
console.log(task.id, task.poll_url);

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

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

جسم الطلب

string

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

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

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

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

الاستجابة

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

التسعير

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

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/worlds/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "marble-1.1",
        "prompt": "بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة",
    },
)

task = response.json()
print(task["id"], task["poll_url"])

const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'marble-1.1',
    prompt: 'بلدة ساحلية هادئة عند الغروب مع أزقة ضيقة وأضواء دافئة'
  })
});

const task = await response.json();
console.log(task.id, task.poll_url);

التفويضات

Authorization

string

header

مطلوب

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

الترويسات

X-TokenLab-Delivery-Policy

enum<string>

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

الخيارات المتاحة:

auto,

verified,

official

الجسم

application/json

world_prompt

object

مطلوب

كائن world_prompt الأصلي لـ World Labs للمستخدمين المتقدمين. أنواع التوجيه المدعومة هي نص، صورة، صور متعددة، وفيديو. يمكن لمراجع المحتوى استخدام source=media_asset مع media_asset_id مجهز بواسطة /v1/worlds/media-assets/prepare-upload.

model

enum<string>

افتراضي:marble-1.0

نموذج Marble المراد استخدامه. القيمة الافتراضية هي marble-1.0 لتطابق التوافق الافتراضي الحالي لـ World Labs عند حذف النموذج.

الخيارات المتاحة:

marble-1.0,

marble-1.1,

marble-1.1-plus

prompt

string

نص التوجيه (prompt) المستخدم لتوليد العالم بالنص أو بالصور/الفيديو الموجه.

display_name

string

اسم عرض اختياري للعالم المولد، بحد أقصى 64 حرفاً.

Maximum string length: 64

image

string

توجيه صورة بصيغة Base64 أو رابط بيانات.

image_url

string<uri>

توجيه رابط صورة.

images

(string | object)[]

اختصارات توجيه الصور المتعددة. قدم ما يصل إلى 4 صور. استخدم world_prompt.reconstruct_images=true الأصلي لما يصل إلى 8 صور.

Maximum array length: 4

video_url

string<uri>

توجيه رابط فيديو.

is_pano

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

seed

integer

بذرة (seed) اختيارية من 0 إلى 4294967295.

النطاق المطلوب: 0 <= x <= 4294967295

الاستجابة

تم إنشاء المهمة

string

task_id

string

operation_id

string

status

enum<string>

الخيارات المتاحة:

pending,

processing,

completed,

failed

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

object

الأساسيات

النص

الملفات والدفعات

الصور

الصوت والوقت الفعلي

الموسيقى

الفيديو والمواد

Worlds

3D

المهام غير المتزامنة

Gemini الأصلي

الإدارة

جسم الطلب

الاستجابة

التسعير

التفويضات

الترويسات

الجسم

الاستجابة

​جسم الطلب

​الاستجابة

​التسعير

التفويضات

الترويسات

الجسم

الاستجابة

جسم الطلب

الاستجابة

التسعير