Worlds
إعداد رفع أصل الوسائط
إنشاء هدف رفع لأصل وسائط World Labs
أنشئ سجل أصل وسائط 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.
نص الطلب
اسم الملف الأصلي، حتى 64 حرفًا، على سبيل المثال reference.png.
نوع الوسائط: image أو video.
امتداد اختياري مثل png أو jpg أو mp4.
بيانات وصفية مخصصة مخزنة مع الأصل.
الاستجابة
البيانات الوصفية لأصل الوسائط المُعدّ: media_asset_id، وfile_name، وkind، وextension، وmetadata، وcreated_at، وupdated_at.
عنوان URL موقّع لرفع الملف.
طريقة HTTP المستخدمة عند رفع الملف الثنائي إلى upload_info.upload_url، عند إرجاعها.
الترويسات المطلوب تضمينها مع عملية الرفع الثنائي، عند إرجاعها.
الطلب
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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
جسم الطلب
application/json
الاستجابة
application/json
application/json