שרת MCP

SeedRouter מפעילה שרת Model Context Protocol מרוחק. סוכן AI יכול להשתמש בו כדי להציג רשימת מודלים לתמונה ולווידאו, לקרוא את סכמות הבקשה והמחירים שלהם, לשלוח משימות יצירה ולשלוף את התוצאות, בלי שתצטרך לכתוב קוד לאינטגרציה.

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 מסוכני AI.
• מזהי המודלים והפרמטרים הם אלה שמופיעים בתיעוד של כל מודל. מודל מופיע ב-list_models ברגע שהוא זמין ב-API.
• מודלי טקסט אינם מוצעים דרך MCP. קרא להם בנקודות הקצה לטקסט, או הפעל באמצעותם סוכן תכנות כפי שמתואר בסוכני תכנות ב-SeedRouter.