كتالوج الأدوات
اكتشف أدوات 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_schema | JSON Schema لـ input في جسم الاستدعاء. صارم: يُرفض أي مفتاح غير معروف ولا يُتجاهل. |
output_schema | JSON Schema لـ result في الاستجابة. مفتوح: قد تظهر حقول جديدة. |
الأدوات في v1
GET /v1/direct/tools هو القائمة المرجعية المحدّثة دائمًا. في v1:
الحساب والكتالوج (مجانية)
| الأداة | النطاق | الوظيفة |
|---|---|---|
list_voices | لا يلزم | الأصوات التي يوفرها نموذج كلام، لكل منها voice_id |
list_projects | projects:read | مشاريعك |
list_workflows، get_workflow | projects:read | سير العمل المحفوظة |
list_characters | assets:read | الشخصيات المدرَّبة، مع المعرّف الذي يأخذه التعديل |
list_elements | assets:read | عناصر مؤسستك (Elements: الشخصيات والأنماط المدرَّبة)، مع المعرّف الذي يأخذه التوليد كمرجع |
plan_media | assets:read | التحقق من خطة متعددة الخطوات وتسعيرها؛ راجع احصل على عرض سعر قبل الإنفاق |
المكتبة (مجانية)
| الأداة | النطاق | الوظيفة |
|---|---|---|
list_assets | assets:read | المرفوعات وعمليات التوليد والمستندات، مع الروابط؛ ويظهر هنا أيضًا الملف الذي قدّمته عبر عنوان URL |
list_generations | assets: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_timeline | projects:read | مجانية |
filmlab_create_timeline | assets:write | مجانية |
filmlab_get_documentation | لا يلزم | مجانية |
filmlab_edit | generations:write وassets:write | لكل أمر |
filmlab_export | generations:write | تعيد عملية توليد |
ما ليس في Direct API
| أداة MCP | استخدم بدلًا منها |
|---|---|
list_models | النماذج |
get_credit_balance | GET /v1/direct/me |
get_generation_status، wait_for_generations، show_generation، show_asset | GET /v1/direct/generations/{id} وPOST /v1/direct/generations/batch-get |
إذا واجهت أي مشكلة أو كانت لديك أي أسئلة، فلا تتردد في التواصل معنا. يسعدنا مساعدتك. اكتب لنا على support@morphic.com.