HomeSupportStudio
Direct API

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

اكتشف أدوات 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الشخصيات المدرَّبة، مع المعرّف الذي يأخذه التعديل
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.

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

النطاق 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.

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

تحتاج 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.

الحدود

حدود معدل الطلبات في Direct API، والترويسات التي تُبلغ عنها، وحدود الحجم والعدد.

النماذج

النماذج التي توفرها Direct API، مرتبة حسب معرّف نموذج Morphic، مع القدرات والخيارات التي يقبلها كل منها.

في هذه الصفحة

اكتشاف الأدواتالأدوات في v1الحساب والكتالوج (مجانية)المكتبة (مجانية)الصور (مدفوعة، تعيد عمليات توليد)الفيديو (مدفوعة، تعيد عمليات توليد)الصوت (مدفوعة، تعيد عمليات توليد)التحليل (مدفوعة، تُجيب ضمن الاستدعاء)الخطوط الزمنية في Composeما ليس في Direct API