خادم MCP

يشغّل SeedRouter خادم Model Context Protocol بعيدًا. يمكن لوكيل ذكاء اصطناعي استخدامه لعرض قائمة نماذج الصور والفيديو، وقراءة مخططات طلباتها وأسعارها، وإرسال مهام الإنشاء وجلب النتائج، من دون أن تكتب شفرة للتكامل.

https://api.seedrouter.ai/v1/mcp

• النقل: Streamable HTTP، عديم الحالة. يدعم الخادم إصدار البروتوكول 2026-07-28 والإصدارات السابقة التي تبدأ بمصافحة initialize، وصولًا إلى 2024-11-05.
• المصادقة: مفتاح API الخاص بك في SeedRouter كرمز Bearer، Authorization: Bearer YOUR_API_KEY. أنشئ مفتاحًا من صفحة مفاتيح API؛ راجع المصادقة.
• الفوترة: كما في واجهة HTTP API. كل استدعاء لـsubmit_task هو طلب واحد إلى نقطة نهاية المهمة المقابلة، وتُحتسب رسومه بالطريقة نفسها.

لا يمكن حاليًا ربط العملاء الذين لا يتيحون تسجيل الدخول إلا باستخدام OAuth ولا يتضمنون حقلًا لترويسة مخصّصة.

ربط عميل

تتضمن صفحة مفاتيح API زر الاتصال عبر MCP الذي يُدرج أحد مفاتيحك في إعدادات كل عميل أدناه.

Claude Code

claude mcp add --transport http seedrouter https://api.seedrouter.ai/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

أضف إلى ~/.cursor/mcp.json، أو إلى .cursor/mcp.json في مشروع:

{
  "mcpServers": {
    "seedrouter": {
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

يقرأ Codex المفتاح من متغيّر بيئة:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex mcp add seedrouter --url https://api.seedrouter.ai/v1/mcp \
  --bearer-token-env-var SEEDROUTER_API_KEY

يحفظ Codex اسم المتغيّر، لا المفتاح. شغّل Codex من صدفة ضُبط فيها SEEDROUTER_API_KEY، مثلًا بتصديره في ملف إعداد الصدفة.

VS Code

أضف إلى .vscode/mcp.json:

{
  "servers": {
    "seedrouter": {
      "type": "http",
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

يُعدّ أي عميل آخر يدعم خوادم Streamable HTTP البعيدة مع ترويسة Authorization مخصّصة بالطريقة نفسها.

الأدوات

لا يعطي تكرار استدعاء submit_task النتيجة نفسها دون أثر إضافي. فإعادة الاستدعاء تنشئ مهمة ثانية وتخصم تكلفتها، لذا تحقق من get_task أو get_balance أو سجل المهام قبل إعادة استدعاء لم تتلقَّ نتيجته.

سير العمل المعتاد

1. استدعِ list_models مع endpoint: "images".
2. استدعِ get_model_schema للنموذج الذي اخترته.
3. اختياريًا، استدعِ get_pricing للاطلاع على السعر أولًا.
4. استدعِ submit_task مع model وinput مطابق للمخطط.
5. استدعِ get_task مع wait_seconds: 50، وكرّر ما دامت قيمة status هي processing، ثم اقرأ output. تُظهر مهام Seedance الحالتين queued وrunning قبل succeeded.

الإنشاء غير متزامن، تمامًا كما في واجهة HTTP API: يعيد submit_task الاستجابة بمجرد قبول المهمة. يوفّر wait_seconds على الوكيل الاستعلام ضمن حلقة، لكن قد يتطلب فيديو طويل عدة استدعاءات لـget_task. إذا أخفق التحقق من الحالة لسبب مؤقت أثناء الانتظار، مثل بلوغ حد معدل الطلبات أو حدوث خطأ في الخادم، يعيد get_task آخر نتيجة بحالة processing بدلًا من الخطأ؛ استدعِه مجددًا.

القواعد الموروثة من واجهة HTTP API

• يجب أن تكون الصور والفيديوهات والملفات الصوتية المرجعية روابط http(s) عامة. تُرفض المدخلات بصيغة Base64.
• عندما تجيب واجهة HTTP API، يكون جسم استجابتها هو نتيجة الأداة دون تغيير، مع رموز الأخطاء نفسها. أما الأخطاء التي تحدث قبل وصول الطلب إليها، مثل نموذج غير معروف أو معاملات أداة غير صالحة، فتُعاد كرسالة خطأ بسيطة. ويؤدي رفض المفتاح في نقطة نهاية MCP نفسها إلى استجابة HTTP 401.
• لا تُحتسب رسوم على المهام الفاشلة.
• يمكن للحساب افتراضيًا تشغيل ما يصل إلى 50 مهمة صور وفيديو في الوقت نفسه. تعيد الإرسالات الإضافية HTTP 429 مع الرمز 30002 حتى تكتمل مهام قيد التنفيذ؛ راجع استخدام SeedRouter من وكلاء الذكاء الاصطناعي.
• معرّفات النماذج ومعاملاتها هي المذكورة في وثائق كل نموذج. يظهر النموذج في list_models بمجرد إتاحته في واجهة API.
• لا تتوفر نماذج النصوص عبر MCP. استدعِها من نقاط نهاية النصوص، أو شغّل وكيل برمجة باستخدامها كما هو موضّح في وكلاء البرمجة على SeedRouter.