API GPT Image 2.6 jest już dostępne. Wypróbuj generowanie obrazów →
PoYoPoYo

Serwer PoYo MCP

Twój agent AI i każdy model PoYo w jednym miejscu.

Połącz się raz, a Codex, Claude Code, Cursor i VS Code będą mogły wyszukiwać modele obrazu, wideo, audio, czatu i 3D, sprawdzać aktualne schematy i publiczny cennik oraz uruchamiać zadania przez PoYo.

MCP to bezpieczne połączenie, dzięki któremu twój asystent AI korzysta z modeli PoYo bez konieczności pisania żądań API.

npx -y @poyoapi/mcp

Lokalny most stdio dla VS Code lub klientów obsługujących wyłącznie stdio. Wymaga Node.js 20+; skorzystaj z konfiguracji poniżej, aby połączyć się krok po kroku.

Utwórz klucz APIZobacz konfiguracjęCzytaj dokumentację MCP

Konfiguracja

Połącz się w trzech krokach. Konfigurację zaawansowaną otwórz tylko wtedy, gdy chcesz ograniczyć kategorie narzędzi lub modele.

1

Przygotuj klucz API

Najpierw utwórz klucz API PoYo. Użyjesz go podczas łączenia klienta.

Nie wklejaj prawdziwego klucza API do współdzielonego pliku konfiguracji ani adresu URL.

Utwórz klucz API
2

Wybierz klienta i znajdź jego konfigurację

Wybierz aplikację, z której korzystasz, aby zobaczyć jedną odpowiednią lokalizację konfiguracji.

Polecany punkt wejścia

Otwórz Codex Settings, wybierz „MCP servers”, potem „Add server” i wskaż Streamable HTTP.

Zobacz oficjalne instrukcje klienta

Plik konfiguracji do ręcznej edycji

~/.codex/config.toml

Dotyczy

Wszystkie projekty bieżącego użytkownika

Otwórz konfigurację MCP w kliencie. Jeśli nie ma graficznego punktu wejścia, otwórz lub utwórz powyższy plik.

Ścieżki zaczynające się od ./ znajdują się w aktualnie otwartym folderze projektu. W razie potrzeby utwórz folder lub plik.

3

Dodaj konfigurację i zweryfikuj

Skopiuj konfigurację dla wybranego klienta, przeładuj MCP i wykonaj darmową weryfikację.

Scal z istniejącą konfiguracją, nie nadpisuj jej

Jeśli plik zawiera już inne serwery MCP, scal tylko wpis serwera poyo i zachowaj całą dotychczasową zawartość. Nadpisanie może wyłączyć inne połączenia.

Dodaj poniższą konfigurację do ~/.codex/config.toml

[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45

Zapisz swój klucz API jako zmienną środowiskową POYO_API_KEY, zanim uruchomisz klienta. Po zapisaniu rozpocznij nową sesję Codex, aby konfiguracja MCP została wczytana ponownie.

Jak ustawić POYO_API_KEY?

Skopiuj polecenie dla swojego systemu, zastąp your_api_key prawdziwym kluczem i uruchom klienta z tej samej sesji terminala.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Te polecenia działają tylko w bieżącej sesji terminala. Nie umieszczaj prawdziwego klucza w plikach projektu, zrzutach ekranu ani publicznych logach poleceń.

Czytaj dokumentację MCP
Pozwól, by agent pomógł w konfiguracji

Skopiuj bezpieczny prompt, w którym agent ma zachować istniejące ustawienia, nie zapisywać prawdziwego klucza w plikach i pokazać diff przed zapisem.

Zweryfikuj połączenie

Sprawdź te stany po kolei. Żaden z nich nie uruchamia płatnego zadania modelu.

  1. 1Narzędzia PoYo pojawiają się w kliencie, co potwierdza wczytanie konfiguracji.
  2. 2poyo_account zwraca informacje o koncie, co potwierdza, że klucz API działa.
  3. 3poyo_search_models zwraca modele, co potwierdza dostęp do katalogu.
Połączenie nie działa?
  • Brak narzędzi: sprawdź lokalizację konfiguracji, a następnie przeładuj serwer MCP.
  • Sprawdzenie konta nie powiodło się: upewnij się, że POYO_API_KEY jest ustawiony, a następnie uruchom klienta ponownie w tym samym środowisku.
  • Połączenie nie powiodło się: upewnij się, że endpoint to https://api.poyo.ai/mcp, a twoja sieć lub proxy zezwala na dostęp przez HTTPS.

Gdy wszystkie sprawdzenia narzędzi, konta i katalogu zakończą się powodzeniem, połączenie z PoYo MCP jest gotowe.

Co agent może zrobić z PoYo MCP?

Opisz zadanie zwykłym językiem. Agent wyszukuje pasujący model, odczytuje jego dane wejściowe i cenę, uruchamia go, a po zakończeniu długiego zadania zwraca wynik.

Wykrywanie modeli

Wyszukuje aktualne modele obrazu, wideo, audio, czatu lub 3D na podstawie zadania opisanego zwykłym językiem

poyo_search_models
Modele do rozważenia

Odczyt danych wejściowych

Odczytuje aktualny schemat danych wejściowych, przykłady, protokoły i możliwości

poyo_get_model_schema
Poprawne dane wejściowe

Sprawdzanie cen

Odczytuje aktualną publiczną cenę przed uruchomieniem płatnego żądania

poyo_get_pricing
Potwierdzenie ceny

Uruchamianie krótkich zadań

Wykonuje zadania czatu lub generowania, które mogą zwrócić wynik po krótkim oczekiwaniu

poyo_chatpoyo_run_model
Kompletny wynik

Kontynuacja długich zadań

Przesyła zadanie długotrwałe, zachowuje jego task_id i później odczytuje status oraz wyniki

poyo_submit_jobpoyo_check_job
Status i wynik

Odczyt konta

Odczytuje aktualne informacje o koncie i kredytach przed uruchomieniem modelu

poyo_account
Stan konta

Kiedy używać MCP, CLI, a kiedy REST API?

Wybierz MCP, gdy agent ma sam wybierać i wywoływać modele, PoYo CLI do automatyzacji w terminalu lub CI, a REST API do ruchu aplikacji albo wyniku strumieniowanego token po tokenie.

01

Asystent AI lub agent programistyczny

Wybierz

MCP

Streamable HTTP

Dlaczego pasuje

Pozwól, by agent wykrywał modele, czytał schematy i ceny oraz wywoływał narzędzia w edytorze lub rozmowie.

Ty kontrolujesz

Zakres narzędzi i uprawnienia klienta

Czytaj dokumentację
02

Skrypty terminala lub CI

Wybierz

PoYo CLI

@poyoapi/cli

Dlaczego pasuje

Wykrywaj modele, uruchamiaj generowanie, czekaj na zadania i zapisuj JSON, JSONL lub CSV z poziomu powłoki.

Ty kontrolujesz

Flagi poleceń, pliki wejściowe i format wyniku

Czytaj dokumentację
03

Backend twojej aplikacji

Wybierz

REST API

HTTP + JSON / SSE

Dlaczego pasuje

Obsługuj ruch aplikacji, streaming tokenów, polling, webhooks i zadania batch.

Ty kontrolujesz

Cykl życia żądania i sposób działania produktu

Czytaj dokumentację

Najczęstsze pytania

Dowiedz się więcej o połączeniach MCP, kluczach API, zakresie narzędzi, rozliczeniach i wznawianiu długich zadań.

Utwórz klucz API, według dokumentacji MCP dodaj PoYo do swojego klienta, a potem sprawdź swoje konto, schemat modelu i publiczny cennik.

Utwórz klucz APICzytaj dokumentację MCP