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

Worlds

تحضير رفع أصل وسائط

ينشئ هدف رفع لأصل وسائط World Labs

POST
/v1/worlds/media-assets/prepare-upload

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

يسجل TokenLab مالك الأصل. لا يمكن جلب أصل الوسائط أو استخدامه في إنشاء World إلا من نفس المؤسسة.

جسم الطلب

file_namestringمطلوب

اسم الملف الأصلي، حتى 64 حرفا.

kindstringمطلوب

نوع الوسائط: image أو video.

extensionstring | null

امتداد اختياري مثل png أو jpg أو mp4.

metadataobject | null

كائن بيانات وصفية اختياري يحفظ مع أصل الوسائط upstream.

الاستجابة

media_assetobject

بيانات أصل وسائط World Labs المحضر.

upload_info.upload_urlstring

URL upstream موقع لرفع الملف الثنائي.

upload_info.upload_methodstring

طريقة HTTP المستخدمة لرفع الملف الثنائي إلى upload_info.upload_url، عند إرجاعها.

upload_info.required_headersobject

الترويسات المطلوب تضمينها مع رفع الملف الثنائي، عند إرجاعها.

الطلب

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"
  }'
{  "media_asset": {    "created_at": "2019-08-24T14:15:22Z",    "file_name": "string",    "kind": "image",    "media_asset_id": "string",    "extension": "string",    "metadata": {},    "updated_at": "2019-08-24T14:15:22Z"  },  "upload_info": {    "upload_method": "string",    "upload_url": "http://example.com",    "curl_example": "string",    "required_headers": {      "property1": "string",      "property2": "string"    }  }}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

جسم الطلب

application/json

الاستجابة

application/json

application/json

حذف أصل مادي (Material Asset)

السابق

جلب أصل وسائط

التالي