الانتقال إلى المحتوى الرئيسي
أنشئ سجل أصل وسائط في World Labs واحصل على URL لرفع صورة أو فيديو. ارفع الملف الثنائي إلى upload_info.upload_url، ثم استخدم media_asset.media_asset_id داخل world_prompt مع source: "media_asset". يسجل TokenLab مالك الأصل. لا يمكن جلب أصل الوسائط أو استخدامه في إنشاء World إلا من نفس المؤسسة.

جسم الطلب

file_name
string
مطلوب
اسم الملف الأصلي، حتى 64 حرفا.
kind
string
مطلوب
نوع الوسائط: image أو video.
extension
string
امتداد اختياري مثل png أو jpg أو mp4.
metadata
object
كائن بيانات وصفية اختياري يحفظ مع أصل الوسائط upstream.

الاستجابة

media_asset
object
بيانات أصل وسائط World Labs المحضر.
upload_info.upload_url
string
URL upstream موقع لرفع الملف الثنائي.
curl -X POST "https://api.tokenlab.sh/v1/worlds/media-assets/prepare-upload" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "reference.png",
    "kind": "image",
    "extension": "png"
  }'