تمرير وسائطك الخاصة

كل حقل يأخذ وسائط (image_asset_id، وreference_video_asset_ids، وasset_id، وكل حقل آخر من نوع *_asset_id أو *_asset_ids) يقبل إما معرّف أصل من مكتبتك أو عنوان URL عامًا بـ HTTPS للملف. يمكنك المزج بينهما بحرية في الاستدعاء نفسه. لا توجد خطوة رفع منفصلة.

curl -s https://mcp.morphic.com/v1/direct/tools/edit_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Put the bike on a beach at sunset", "image_asset_ids": ["https://cdn.example.com/products/bike.jpg"], "project_id": "01928f4e-…"}}'

قبل تشغيل الأداة، يُجلب كل عنوان URL ويُضاف إلى project_id كأصل مرفوع، مجانًا. ثم تعمل الأداة عليه كأي أصل آخر. يحتاج عنوان URL إلى النطاق assets:write، ويُحتسب كل عنوان URL مميز استدعاءً واحدًا ضمن حصة الاستدعاءات المجانية.

• يجب أن يكون عنوان URL بروتوكول HTTPS على مضيف عام، وأن يقدّم الملف نفسه، لا صفحة ويب.
• لملف في التخزين الخاص بك، مرّر عنوان URL موقَّعًا (طلب GET موقَّع مسبقًا من S3، أو عنوان URL موقَّعًا من GCS). أبقِه صالحًا حتى يصل رد الاستدعاء.
• تُقبل الصور والفيديو والصوت والمستندات (.pdf، .txt، .md، .srt). وتُفحص البايتات، لذا لا يُعتمد على الامتداد أبدًا.
• يمكن أن يصل حجم ملف الوسائط إلى 100 ميغابايت، أو إلى حد الرفع في خطتك إن كان أقل، ويجب أن يصل خلال 25 ثانية.
• عنوان URL المذكور مرتين في الاستدعاء نفسه يُجلب مرة واحدة. أما الاستدعاء اللاحق فيجلبه من جديد؛ لإعادة استخدام ملف دون جلبه مرة أخرى، مرّر معرّف الأصل الذي تعرضه له list_assets.
• يُتحقق من مدخلات الاستدعاء وفق مخطط الأداة قبل جلب أي عنوان URL. الاستدعاء غير السليم يُرجع 400 invalid_request ولا يجلب شيئًا.
• عنوان URL الذي يتعذر جلبه أو لا يُقبل يُرجع 422 tool_refused مع اسم الحقل، مثل input.image_asset_ids[0]: The URL must use https. لا يبدأ أي شيء ولا يُحتسب أي رسم. يبقى الملف الذي أُضيف بالفعل في المشروع، كما هو الحال عندما ترفض الأداة نفسها الاستدعاء بعد ذلك.
• تأخذ analyze_video وanalyze_audio المعامل project_id لهذا الغرض فقط: أرسله عندما يحتوي حقل وسائط على عنوان URL.
• تقبل خطوات plan_media عناوين URL أيضًا، ويُضاف كل منها إلى project_id الخاص بخطوته، لذا يضيف عرض السعر تلك الملفات إلى مكتبتك. مرّر إلى الخطوات التي تشغّلها معرّفات الأصول التي تعرضها list_assets حينها، بدلًا من عناوين URL، لجلب كل ملف مرة واحدة.

إذا واجهت أي مشكلة أو كانت لديك أي أسئلة، فلا تتردد في التواصل معنا. يسعدنا مساعدتك. اكتب لنا على support@morphic.com.