Direct API

تمنح Morphic Direct API الواجهة الخلفية لديك أدوات التوليد والتحرير والمكتبة نفسها التي يمنحها خادم Morphic MCP لمساعد الذكاء الاصطناعي، عبر HTTPS وJSON العاديين. تستدعي أداةً باستخدام مفتاح API للمؤسسة، ويُبلغ كل استدعاء مدفوع بما خصمه، وتتابع كل عملية توليد عبر الاستطلاع أو عبر ويبهوك موقَّع.

نظرة سريعةCopy Anchor Link

الحصول على الوصولCopy Anchor Link

تُفعَّل Direct API لكل مؤسسة على حدة، بدعوة. وإلى أن تُفعَّل، يُجاب كل استدعاء بـ 403 direct_api_disabled.

1. اطلب من جهة الاتصال الخاصة بحسابك في Morphic تفعيل Direct API لمؤسستك. تفعّل Morphic أيضًا الأدوات المدفوعة بعد اعتماد نموذج الطلب الخاص بك؛ وحتى ذلك الحين لا تظهر نطاقات Direct API في Studio، وتُجيب الأدوات المدفوعة بـ 403 tool_not_available.
2. ينشئ أحد مسؤولي مؤسستك مفتاحًا في Studio، ضمن 'Settings' > 'API keys'، ويقبل شروط استخدام Morphic، بما في ذلك القسم الخاص بواجهة API للمطورين، نيابةً عن المؤسسة. راجع إنشاء مفتاح.
3. استدعِ الواجهة باستخدام Authorization: Bearer <secret>.

البدء السريعCopy Anchor Link

اعثر على المشروع الذي يجب أن تصل إليه المخرجات، وابدأ توليد صورة، ثم انتظرها.

export MORPHIC_API_KEY=mor_live_9f2c…   # created once in Studio > Settings > API keys

# 1. Which project should the output land in?
curl -s https://mcp.morphic.com/v1/direct/tools/list_projects \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {}}'

# 2. Start an image
curl -s https://mcp.morphic.com/v1/direct/tools/generate_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4411-hero-image" \
  -d '{
        "input": {
          "prompt": "A red vintage bicycle against a pastel wall, soft morning light",
          "aspect_ratio": "16:9",
          "project_id": "01928f4e-5b7c-7d2a-9e11-3c4b5a6d7e8f"
        },
        "webhook_id": "01929a10-0c3d-7f44-8a21-0b1c2d3e4f50",
        "metadata": { "order_id": "4411" }
      }'

# 3. Wait for it (holds up to 45 s, returns the moment it finishes)
curl -s "https://mcp.morphic.com/v1/direct/generations/0192a7b3-…?wait=45" \
  -H "Authorization: Bearer $MORPHIC_API_KEY"

تصل كل عملية توليد إلى مكتبة Morphic الخاصة بمؤسستك، في المشروع الذي حددته، كما لو أنها أُنشئت في Studio. وتظهر في Studio على أنها أُنشئت عبر API، ويعرض مرشّح المكتبة 'Created by' > 'API' كل ما أنشأته مفاتيح API لديك أو استوردته.

نقاط النهايةCopy Anchor Link

اقرأ التاليCopy Anchor Link

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