Przejdź do treści głównej

MCP i agenci

Pozwól asystentowi AI tworzyć obrazy i wideo

Oficjalny serwer MCP daje asystentom (Claude, Cursor, Codex, VS Code i inne) aktualny katalog modeli, dokładne wyceny i tworzenie zadań. Ty prosisz własnymi słowami, a asystent zatrzymuje się i pyta o zgodę, zanim cokolwiek pobierze.

Utwórz klucz APIPełny przewodnik w dokumentacji

Czym jest serwer MCP?

MCP (Model Context Protocol) to standardowy sposób na dodanie asystentowi AI nowych narzędzi. Dodaj serwer SpicyAPI, a asystent przejrzy modele, sprawdzi ceny i stworzy dla Ciebie obrazy lub wideo.

  1. Ty i Twój asystentClaude, Cursor, Codex, VS Code…
  2. Serwer MCP SpicyAPIDziała na Twoim komputerze przez npx
  3. Modele obrazu i wideoAktualny katalog, dokładne ceny
Asystent sam wybiera narzędzie do wywołania. Wszystko, co kosztuje, zatrzymuje się i czeka na Twoją zgodę.

Do czego się nadaje

  • Grafiki podczas kodowaniaPoproś o baner lub klip produktowy, nie wychodząc z edytora.
  • Odkrywanie modeliZapytaj, który model pasuje do zadania i ile to kosztuje.
  • Serie zadań obsługiwane przez agentaNiech agent sam utworzy zadania, poczeka na nie i zbierze wyniki.

Co się dzieje, gdy o coś prosisz

  1. Krok 1Znajduje odpowiedni model w aktualnym katalogu i sprawdza, co przyjmuje
  2. Krok 2Wysyła Twój lokalny plik, jeśli jakiś jest
  3. Krok 3Pobiera dokładną wycenę w dolarach i pyta Cię, zanim cokolwiek pobierze
  4. Krok 4Uruchamia zadanie, czeka na nie i podaje link do wyniku
Przykładowa sesja

  1. Ty: Zamień beach.jpg w sześciosekundowy klip z falami o zachodzie słońca.

  2. spicyapi_models_listspicyapi_model_get
    Asystent: Znaleziono model wideo przyjmujący obraz początkowy
  3. spicyapi_upload_file
    Wysłano beach.jpg
  4. spicyapi_task_quote

    Oto dokładna cena w dolarach. Utworzyć zadanie?

  5. spicyapi_task_createspicyapi_task_wait
    Gotowe. Oto Twój link do pobrania.
Ilustracja typowej sesji. Nic nie jest pobierane, dopóki nie zatwierdzisz.

Dodaj go do swojego asystenta

Każdy klient uruchamia ten sam lokalny serwer przez npx. Wybierz swojego, aby zobaczyć dokładne polecenie lub blok konfiguracji.

{
  "mcpServers": {
    "spicyapi": {
      "command": "npx",
      "args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
      "env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
    }
  }
}

Jeden serwer stdio dla każdego klienta MCP. Wklej blok do pliku konfiguracyjnego tego klienta.

Klienty zewnętrzne zmieniają format konfiguracji między wersjami. Jeśli podany przykład przestanie pasować, kieruj się dokumentacją danego klienta.

Używasz Claude? Generuj obrazy i wideo prosto w Claude →

Udostępniane narzędzia

Narzędzia tylko do odczytu są bezpłatne. Dwa narzędzia, które wydają pieniądze, i to, które usuwa treści, zawsze najpierw pytają o zgodę.

BezpłatneBezpłatne, tylko do odczytu12

  • spicyapi_service_statusPubliczne sprawdzenie stanu, bez klucza
  • spicyapi_docs_searchPrzeszukiwanie dołączonej dokumentacji
  • spicyapi_models_listWłączone modele i Twoje ceny
  • spicyapi_model_getJeden model i jego schemat wejścia
  • spicyapi_balance_getSaldo dostępne, zarezerwowane i łączne
  • spicyapi_usage_getIle wydał bieżący klucz
  • spicyapi_tasks_listOstatnie zadania bieżącego klucza
  • spicyapi_task_getJedno zadanie z gotowymi linkami do wyniku
  • spicyapi_task_waitCzekanie do 5 minut na zakończenie zadania
  • spicyapi_task_quoteWycena dokładnego żądania bez tworzenia zadania
  • spicyapi_upload_fileWysłanie lokalnego pliku jako wejścia
  • spicyapi_download_url_createNowy link do pobrania wyniku

Pyta o zgodę przed pobraniem opłatyPytają przed uruchomieniem3

  • spicyapi_task_createUruchomienie zadania generowania
  • spicyapi_task_retryPonowne uruchomienie nieudanego lub wygasłego zadania
  • spicyapi_task_purgeTrwałe usunięcie treści zakończonego zadania
Otwórz pakietZobacz kod źródłowy

Dodaj Agent Skill określający kolejność wywołań

Serwer MCP daje agentowi możliwości, a Agent Skill uczy go, jak z nich korzystać: odczytać schemat, potwierdzić wycenę i użyć jednego klucza idempotencji na próbę. Claude Code i Codex obsługują oba.

Otwórz pakietZobacz kod źródłowy
npx skills add spicyapi-ai/spicy-skill \
  --agent claude-code

Pliki, które agent może odczytać

Te pliki pomagają asystentom i narzędziom integracyjnym znaleźć opis produktu, katalog modeli i oficjalną dokumentację.

agent.md

Zwięzły kontrakt integracji agenta i granice bezpieczeństwa.

/agent.md →

llms.txt

Wyselekcjonowany indeks strony i modeli na potrzeby wyszukiwania przez AI.

/llms.txt →

llms-full.txt

Rozszerzony kontekst produktu, procesów, endpointów i discovery.

/llms-full.txt →

Manifest agenta

Ustrukturyzowany opis JSON dla narzędzi i autonomicznych klientów.

/api/agent →

Typowe błędy i poprawki

Pierwsze problemy zwykle sprowadzają się do tych trzech sytuacji. Każda karta opisuje objaw i jedną zmianę, która go rozwiązuje.

  • tools

    Narzędzia się nie pojawiają

    Zrestartuj asystenta po edycji konfiguracji i sprawdź, czy JSON jest poprawny.

  • klucz

    Brak klucza API

    Wpisz SPICY_API_KEY w bloku env w konfiguracji serwera. Aplikacje desktopowe nie widzą klucza wyeksportowanego w powłoce.

  • pytaj

    Nie można tworzyć zadań

    Twój klient nie potrafi pokazać próśb o potwierdzenie. Bezpłatne narzędzia działają; do tworzenia zadań użyj klienta z obsługą elicitation w MCP.

Najczęstsze pytania