كتالوج الأدوات

اكتشف أدوات Direct API ومخططات JSON Schema الخاصة بها، واطّلع على كل أدوات v1 والنطاق الذي تحتاجه كل منها.

تُبنى Direct API من تعريفات الأدوات نفسها التي يُبنى منها خادم Morphic MCP، لذا فإن الكتالوج الذي تقدمه الواجهة هو دائمًا الكتالوج الحي، بما في ذلك كل نموذج تستطيع خطتك استخدامه.

اكتشاف الأدوات

الطلبيعيد
GET /v1/direct/toolsكل أداة يستطيع هذا المفتاح استدعاءها، مع مخططات JSON Schema الكاملة الخاصة بها، بصيغة { "tools": [ … ] }
GET /v1/direct/tools/{tool_name}إدخال واحد من تلك القائمة، بصيغة { "tool": { … } }
GET /v1/direct/openapi.jsonمستند OpenAPI 3.1 للواجهة كاملة، مبني من التعريفات نفسها؛ استخدمه لتوليد عميل مُحدَّد الأنواع
curl -s https://mcp.morphic.com/v1/direct/tools \
  -H "Authorization: Bearer $MORPHIC_API_KEY"
{
  "tools": [
    {
      "name": "generate_image",
      "title": "Generate image",
      "description": "Text to image. TAKES IN: a prompt … PRODUCES: one new image per variation …",
      "required_scopes": ["generations:write"],
      "charges_credits": true,
      "returns_generation": true,
      "input_schema":  { "type": "object", "properties": { "prompt": { "type": "string", "maxLength": 4000 }, "…": {} }, "required": ["prompt"], "additionalProperties": false },
      "output_schema": { "type": "object", "properties": { "generation_id": { "type": "string" }, "…": {} } },
      "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }
    }
  ]
}
الحقلالمعنى
charges_creditsيمكن للأداة إنفاق أرصدة؛ راجع الأرصدة والاستخدام
returns_generationتبدأ الأداة عملًا غير متزامن تتابعه بصفته عملية توليد
input_schemaJSON Schema لـ input في جسم الاستدعاء. صارم: يُرفض أي مفتاح غير معروف ولا يُتجاهل.
output_schemaJSON Schema لـ result في الاستجابة. مفتوح: قد تظهر حقول جديدة.

الأدوات في v1

GET /v1/direct/tools هو القائمة المرجعية المحدّثة دائمًا. في v1:

الحساب والكتالوج (مجانية)

الأداةالنطاقالوظيفة
list_voicesلا يلزمالأصوات التي يوفرها نموذج كلام، لكل منها voice_id
list_projectsprojects:readمشاريعك
list_workflows، get_workflowprojects:readسير العمل المحفوظة
list_charactersassets:readالشخصيات المدرَّبة، مع المعرّف الذي يأخذه التعديل
list_elementsassets:readعناصر مؤسستك (Elements: الشخصيات والأنماط المدرَّبة)، مع المعرّف الذي يأخذه التوليد كمرجع
plan_mediaassets:readالتحقق من خطة متعددة الخطوات وتسعيرها؛ راجع احصل على عرض سعر قبل الإنفاق

المكتبة (مجانية)

الأداةالنطاقالوظيفة
list_assetsassets:readالمرفوعات وعمليات التوليد والمستندات، مع الروابط؛ ويظهر هنا أيضًا الملف الذي قدّمته عبر عنوان URL
list_generationsassets:readعمليات التوليد الأخيرة مع حالتها وأصولها

الصور (مدفوعة، تعيد عمليات توليد)

النطاق generations:write: generate_image، edit_image، upscale_image، enhance_image، outpaint_image، inpaint_image، image_compose، image_crop، image_resize، image_rotate، image_flip، image_extend_to_aspect_ratio، image_make_color_transparent.

الفيديو (مدفوعة، تعيد عمليات توليد)

النطاق generations:write: generate_video، edit_video، upscale_video، enhance_video، finalize_video_draft، lip_sync، video_compose، video_resize، video_change_frame_rate، video_rotate، video_flip، video_change_speed، video_reverse، video_remove_audio، video_frame_to_image، burn_subtitles، video_to_alpha.

يقص video_to_alpha شخصًا أو كائنات مسمّاة من فيديو على خلفية شفافة. ويعمل على خطط Enterprise فقط.

الصوت (مدفوعة، تعيد عمليات توليد)

النطاق generations:write: generate_speech، generate_music، generate_sound_effect، generate_dialogue، change_voice، transcribe_media، separate_stems، dub_media، audio_compose، audio_trim، extract_audio، والمؤثرات الصوتية audio_equalize وaudio_compress وaudio_limit وaudio_gate وaudio_deess وaudio_denoise وaudio_reverb وaudio_gain وaudio_fade، وكل منها يعيد ملفًا صوتيًا جديدًا مطبَّقًا عليه التأثير.

تستقبل dub_media الحقل media_asset_id (ملفًا صوتيًا أو مرئيًا واحدًا)، وtarget_language (وسم BCP-47 واحد مثل hi أو pt-BR؛ وعدة لغات تعني عدة استدعاءات)، وsource_language اختياريًا (يُكتشف عند إغفاله)، وkeyterms اختياريًا (الأسماء والمصطلحات التي تُبقى كما نُطقت، حتى 5 كلمات لكل منها)، وmodel_id اختياريًا. وعلى Morphic Dub (mdl_h2z5a7af7y50) تعيد الفيديو نفسه مع مزامنة الشفاه، ويكون المبلغ المخصوم عند البدء تقديرًا يُسوّى إلى ما أنفقه التشغيل. ويستقبل Morphic Dub أيضًا voice_mode: "assigned" مع voices (كل متحدث كأصل صورة أو صوت أو كوصف قصير، مع voice_id من list_voices لـ mdl_h2z5a7af7y50؛ أصوات الكتالوج فقط)، وملف SRT موقّتًا خاصًا بك في source_transcript_asset_id (اللغة المنطوقة) أو translation_asset_id (لغة الهدف)، عبر عنوان URL أو كمستند في مكتبتك، بأيٍّ من وضعي الأصوات. وعبر MCP يستقبل ElevenLabs Dubbing (model_name: "ElevenLabs Dubbing") ملفي SRT أيضًا، بالأصوات الأصلية: source_language مطلوب معهما، ولا تأتي الترجمة إلا مع نص التفريغ. انظر الدبلجة.

التحليل (مدفوعة، تُجيب ضمن الاستدعاء)

تحتاج analyze_video وanalyze_audio إلى النطاقين generations:write وassets:read. ولا تبدأان أي عملية توليد، ويُسترد المبلغ المخصوم إذا فشل التحليل.

الخطوط الزمنية في Compose

تحتفظ أدوات هذه المجموعة بالبادئة filmlab_ في أسمائها.

الأداةالنطاقالخصم
filmlab_list_timelines، filmlab_read_timelineprojects:readمجانية
filmlab_create_timelineassets:writeمجانية
filmlab_get_documentationلا يلزممجانية
filmlab_editgenerations:write وassets:writeلكل أمر
filmlab_exportgenerations:writeتعيد عملية توليد

ما ليس في Direct API

أداة MCPاستخدم بدلًا منها
list_modelsالنماذج
get_credit_balanceGET /v1/direct/me
get_generation_status، wait_for_generations، show_generation، show_assetGET /v1/direct/generations/{id} وPOST /v1/direct/generations/batch-get

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

في هذه الصفحة