رفع أصل (صورة / فيديو / صوت)

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "GroupId": "group-20260318033332-ab12c",
  "URL": "https://your-cdn.com/zhang/full_body.jpg",
  "AssetType": "Image",
  "Name": "full_body_front"
}
'

{
  "Id": "asset-20260318071009-xy98z"
}

Seedance Assets

رفع أصل (صورة / فيديو / صوت)

ارفع أصلًا إلى مجموعة تملكها. تُقدَّم الأصول كـ عنوان URL قابل للوصول العام فقط (دون base64، ودون جسم ملف). الاستدعاء غير متزامن — استعلم عبر GET /asset/files/{aid} حتى تصبح Status بقيمة Active. بالنسبة لمجموعة بشرية حقيقية، يُقارَن وجه الصورة المرفوعة بالمرجع المُتحقَّق منه؛ وعدم التطابق يستقر على Status: Failed مع Error.Code: FaceMismatch.

خاضع لحد رفع الأصول (افتراضيًا 100).

POST

asset

files

رفع أصل (صورة / فيديو / صوت)

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "GroupId": "group-20260318033332-ab12c",
  "URL": "https://your-cdn.com/zhang/full_body.jpg",
  "AssetType": "Image",
  "Name": "full_body_front"
}
'

{
  "Id": "asset-20260318071009-xy98z"
}

التفويضات

Authorization

string

header

مطلوب

تبدو مفاتيح OrcaRouter API على شكل sk-orca-.... مرّرها في ترويسة Authorization: Bearer sk-orca-....

الجسم

application/json

GroupId

string

مطلوب

معرّف مجموعة تملكها.

URL

string

مطلوب

عنوان URL لصورة / فيديو / صوت قابل للوصول العام.

AssetType

enum<string>

مطلوب

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

Image,

Video,

Audio

Name

string

اختياري؛ يُستخدم فقط في البحث الضبابي لـ ListAssets.

Moderation

object

اختياري. {"Strategy":"Skip"} لتخطّي الفلترة المسبقة للمحتوى.

الاستجابة

تم قبول الأصل (غير متزامن — استعلم عبر GET /asset/files/{id})

string

سرد الأصول جلب أصل (استعلام عن الحالة)