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".

الأصل متاح فقط في Workspace التي أنشأته.

{
  "model": "marble-1.1",
  "world_prompt": {
    "type": "image",
    "image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
  }
}

أرسل نص الطلب هذا إلى إنشاء عالم. يؤدي استخدام media_asset_id ينتمي إلى Workspace أخرى إلى إرجاع 403 media_asset_not_owned؛ بينما يؤدي استخدام معرّف غير معروف إلى إرجاع 404 media_asset_not_found.

نص الطلب

file_namestringمطلوب

اسم الملف الأصلي، حتى 64 حرفًا، على سبيل المثال reference.png.

kindstringمطلوب

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

extensionstring | null

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

metadataobject | null

بيانات وصفية مخصصة مخزنة مع الأصل.

الاستجابة

media_assetobject

البيانات الوصفية لأصل الوسائط المُعدّ: media_asset_id، وfile_name، وkind، وextension، وmetadata، وcreated_at، وupdated_at.

upload_info.upload_urlstring

عنوان URL موقّع لرفع الملف.

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