Serwer MCP

Połącz Claude Code, Cursor, Codex, VS Code i inne klienty MCP z modelami obrazu i wideo SeedRouter za pomocą klucza API.

SeedRouter udostępnia zdalny serwer Model Context Protocol. Agent AI może go używać do wyświetlania listy modeli obrazu i wideo, odczytywania schematów żądań i cen, wysyłania zadań generowania oraz pobierania wyników, bez pisania przez Ciebie kodu integracji.

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

Transport: Streamable HTTP, bezstanowy. Serwer obsługuje wersję protokołu 2026-07-28 oraz wcześniejsze wersje, które rozpoczynają połączenie od uzgodnienia initialize, aż do 2024-11-05.
Uwierzytelnianie: Twój klucz API SeedRouter jako token Bearer, Authorization: Bearer YOUR_API_KEY. Utwórz go na stronie kluczy API; zobacz Uwierzytelnianie.
Rozliczenia: takie same jak w HTTP API. Każde wywołanie submit_task to jedno żądanie do odpowiedniego punktu końcowego zadań, rozliczane w ten sam sposób.

Klienty, które pozwalają logować się wyłącznie przez OAuth i nie mają pola na niestandardowy nagłówek, nie mogą się jeszcze połączyć.

Połącz klienta

Na stronie kluczy API znajdziesz przycisk Połącz przez MCP, który wstawia jeden z Twoich kluczy do konfiguracji każdego z poniższych klientów.

Claude Code

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

Cursor

Dodaj do ~/.cursor/mcp.json lub do .cursor/mcp.json w projekcie:

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

Codex CLI

Codex odczytuje klucz ze zmiennej środowiskowej:

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 zapisuje nazwę zmiennej, a nie klucz. Uruchamiaj Codex z powłoki, w której ustawiono SEEDROUTER_API_KEY, na przykład eksportując tę zmienną w profilu powłoki.

VS Code

Dodaj do .vscode/mcp.json:

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

Każdego innego klienta obsługującego zdalne serwery Streamable HTTP z niestandardowym nagłówkiem Authorization konfiguruje się tak samo.

Narzędzia

Narzędzie	Działanie	Potrąca środki z salda
`list_models`	Zwraca listę identyfikatorów modeli przyjmowanych przez `submit_task`, każdy z linkiem do dokumentacji. Opcjonalny `endpoint`: `images` lub `videos`.	Nie
`get_model_schema`	Zwraca JSON Schema treści żądania modelu. Reguły, których JSON Schema nie potrafi wyrazić, takie jak wymagania warunkowe i ograniczenia między polami, są egzekwowane przez API i opisane na stronie dokumentacji modelu.	Nie
`get_pricing`	Zwraca aktualne ceny katalogowe modelu w USD, na podstawie tych samych bieżących stawek, które są używane do rozliczeń, z uwzględnieniem ewentualnych poziomów cenowych modeli.	Nie
`submit_task`	Wysyła jedno zadanie: `model` oraz `input`, czyli treść żądania opisaną przez `get_model_schema`. Zwraca identyfikator zadania.	Tak, za każde wywołanie, które tworzy zadanie
`get_task`	Zwraca stan i wynik zadania. Opcjonalny parametr `wait_seconds` (0–50) pozwala czekać po stronie serwera, gdy zadanie jest nadal wykonywane.	Nie
`get_balance`	Zwraca pozostałe saldo w USD konta, do którego należy klucz.	Nie

submit_task nie jest idempotentne. Ponowne wywołanie tworzy drugie zadanie i ponownie potrąca środki, więc sprawdź get_task, get_balance lub swoją historię zadań, zanim powtórzysz wywołanie, którego wyniku nie udało Ci się otrzymać.

Typowy przebieg

list_models z endpoint: "images".
get_model_schema dla wybranego modelu.
Opcjonalnie get_pricing, aby najpierw sprawdzić stawkę.
submit_task z model i input zgodnym ze schematem.
get_task z wait_seconds: 50, powtarzane, dopóki status ma wartość processing, a następnie odczyt output. Zadania Seedance zgłaszają queued i running przed succeeded.

Generowanie jest asynchroniczne, dokładnie tak jak w HTTP API: submit_task zwraca odpowiedź, gdy tylko zadanie zostanie przyjęte. wait_seconds zwalnia agenta z odpytywania w pętli, ale długie wideo może nadal wymagać kilku wywołań get_task. Jeśli podczas oczekiwania sprawdzenie stanu nie powiedzie się z przejściowego powodu, takiego jak limit częstotliwości żądań lub błąd serwera, get_task zwraca ostatni wynik processing zamiast błędu; wywołaj je ponownie.

Reguły przejęte z HTTP API

Obrazy, wideo i audio referencyjne muszą być publicznymi adresami URL http(s). Dane wejściowe Base64 są odrzucane.
Gdy HTTP API odpowiada, treść jego odpowiedzi staje się niezmienionym wynikiem narzędzia, z tymi samymi kodami błędów. Błędy powstałe, zanim żądanie dotrze do API, takie jak nieznany model lub nieprawidłowe argumenty narzędzia, są zwracane jako zwykły komunikat błędu. Odrzucony klucz w samym punkcie końcowym MCP skutkuje HTTP 401.
Nieudane zadania nie są naliczane.
Domyślnie konto może mieć jednocześnie do 50 zadań obrazu i wideo w toku. Kolejne próby wysłania zwracają HTTP 429 z kodem 30002, dopóki wykonywane zadania się nie zakończą; zobacz Korzystanie z SeedRouter przez agentów AI.
Identyfikatory modeli i parametry są takie jak w dokumentacji każdego modelu. Model pojawia się w list_models, gdy tylko zostanie udostępniony w API.
Modele tekstowe nie są udostępniane przez MCP. Wywołuj je przez punkty końcowe tekstu lub uruchom na nich agenta programistycznego zgodnie z opisem w Agenci programistyczni na SeedRouter.

On this page