1
Sprawdź środowisko i uruchom CLI
Wymagany jest Node.js 20 lub nowszy. Jeśli node --version wypisze v20 lub wyższą wersję, uruchom CLI bezpośrednio przez npx, bez instalacji globalnej.
node --version
npx -y @poyoapi/cli helpPoYo CLIpakiet npm dostępny
Każdy model PoYo — z terminala, skryptów i systemów agentowych.
Przeglądaj schematy wejścia i publiczne ceny modeli dostępnych obecnie w aktualnym katalogu PoYo, bez klucza API. Klucz dodaj dopiero wtedy, gdy uruchamiasz model. Jeśli zadanie trwa dłużej, niż CLI czeka, możesz dalej sprawdzać jego status z tym samym task_id.
$npx -y @poyoapi/cli helpTrzy kroki od odkrycia do wyniku
Bez instalacji globalnej. Sprawdź Node.js, przejrzyj model, uwierzytelnij się i wykonaj pierwsze uruchomienie.
2
Znajdź model i sprawdź jego schemat
Ten przykład znajduje aktualnie dostępny model gpt-image-2, a następnie odczytuje jego aktualny schemat wejścia i publiczną cenę. Żadne z tych poleceń nie wymaga klucza API.
npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1
npx -y @poyoapi/cli describe gpt-image-23
Zaloguj się, zweryfikuj i uruchom
Utwórz klucz API, a następnie wykonaj po kolei trzy poniższe polecenia. Przed płatnym uruchomieniem sprawdź cenę poleceniem describe; nieudane generowania nie zużywają kredytów.
Utwórz klucz API1. Zapisz klucz API
Oczekiwany efekt: CLI prosi o klucz bez wyświetlania go na ekranie, a następnie podaje keyring lub config jako miejsce zapisu. Jeśli systemowy magazyn poświadczeń jest niedostępny, CLI zapisuje klucz w pliku konfiguracyjnym PoYo.
npx -y @poyoapi/cli auth login2. Zweryfikuj konto i saldo
Oczekiwany efekt: dane konta i dostępne saldo. Kod 401 oznacza, że klucz nie został podany lub jest nieprawidłowy.
npx -y @poyoapi/cli account3. Potwierdź cenę i uruchom
To płatne żądanie. Pomyślny wynik JSON zawiera task_id, końcowy status i pliki wyjściowe.
npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --format jsonStworzony do prawdziwych procesów multimodalnych
Aktualny katalog mówi CLI, jakie modele istnieją, jakie dane wejściowe przyjmują, jak długo śledzone są zadania i jaki format wyjścia otrzymują skrypty.
Szukaj, zanim uruchomisz
models wyświetla publiczny katalog. describe zwraca dokładny schemat, obsługiwane protokoły, tryb wykonania, obsługę callbacków i metadane rozliczeniowe dla jednego modelu.
Te dwa polecenia nie wymagają klucza API.
Schemat zamienia się we flagi poleceń
CLI odczytuje aktualny schemat każdego modelu i udostępnia jego pola jako opcje wiersza poleceń specyficzne dla modelu.
Nieznane flagi modelu kończą się błędem lokalnie. Walidacja wymaganych pól i pełna walidacja JSON Schema nadal odbywają się w API.
Wyślij raz, kontynuuj przez task_id
submit od razu zwraca task_id. task get odczytuje bieżący stan, a task wait sprawdza status do ukończenia lub przekroczenia limitu czasu.
Do wideo, audio, 3D i innych długich zadań wybieraj submit.
Uporządkowane wyjście dla skryptów i CI
Dla ludzi wybierz wyjście w tabeli, dla skryptów i CI — JSON, JSONL lub CSV. Polecenia bez strumieniowania mogą też zapisywać wyniki do pliku.
Używaj --output FILE z poleceniami bez strumieniowania. Strumieniowany tekst i JSONL pozostają na stdout.
Jak wygląda prawdziwa sesja PoYo
Przeglądaj publiczny katalog, sprawdź aktualne dane wejściowe i cenę jednego modelu, a potem zażądaj uporządkowanego wyjścia dla swoich skryptów.
~/projects/poyo-demo
# 1. Znajdź model i sprawdź jego schemat
$ npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1
# 2. Sprawdź aktualny schemat
$ npx -y @poyoapi/cli describe gpt-image-2
prompt string required
size string default: "1:1"
output_format string enum: jpeg | png
# 3. Zaloguj się, zweryfikuj i uruchom
$ npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --size 4:3 --output-format png --format json
{
"task_id": "task_7f31b2",
"status": "succeeded",
"files": ["https://storage.poyo.ai/.../image.png"]
}Cykl życia zadania
Długich zadań nie trzeba zaczynać od nowa
Wyślij wideo, audio, 3D i inne długotrwałe zadania raz. Zachowaj task_id i czekaj dalej z innego terminala lub kroku CI.
Przekroczenie limitu czasu w CLI nie anuluje zadania w backendzie. Kontynuuj z tym samym task_id zamiast wysyłać tę samą pracę ponownie.
Używaj submit, gdy terminal nie powinien czekać
$ npx -y @poyoapi/cli submit gpt-image-2 --prompt "cinematic product photo" --format jsontask_id task_7f31b2
$ npx -y @poyoapi/cli task wait TASK_ID --timeout 300 --format jsonstatus succeeded
Używaj run, gdy wystarczy 90 sekund
run sprawdza zadanie co dwie sekundy i domyślnie czeka do 90 sekund. Możesz ustawić inny limit czasu.
Używaj submit, gdy terminal nie powinien czekać
Skopiuj task_id zwrócony przez submit i zastąp TASK_ID w poleceniu wait. Możesz kontynuować z innego terminala lub kroku CI.
Wybierz interfejs dopasowany do wywołującego
Wybieraj CLI dla ludzi i skryptów powłoki, MCP dla wywołań narzędzi w systemach agentowych, REST wewnątrz aplikacji, a Skill, by system agentowy dostał powtarzalne kroki PoYo i zasady bezpieczeństwa.
PoYo CLI
Programiści, terminale i CI
Osoba lub skrypt powłoki musi odkrywać modele, uruchamiać je, wznawiać zadania i reagować na kody wyjścia procesu.
Zainstaluj CLIMCP
Systemy agentowe AI i klienci programistyczni
System agentowy ma odkrywać schematy, ceny i narzędzia wykonawcze przez jedno połączenie.
Zobacz MCPREST API
Aplikacje i usługi
Twoja aplikacja potrzebuje bezpośredniej kontroli HTTP nad żądaniami, streamingiem, ponowieniami i callbackami.
Otwórz dokumentacjęPoYo Skill
Powtarzalne procesy agentowe
System agentowy potrzebuje powtarzalnych kroków działania i zasad bezpieczeństwa obok dostępu przez CLI, MCP lub REST.
Zobacz SkillNajczęstsze pytania o PoYo CLI
Nadal masz wątpliwości co do polecenia? Skontaktuj się ze wsparciem PoYo→
PoYo CLI to klient wiersza poleceń do wyszukiwania i wywoływania modeli czatu, obrazów, wideo, audio i 3D w PoYo. Odczytuje aktualne definicje modeli z publicznego katalogu możliwości, zamienia pola schematu na opcje poleceń i używa tych samych endpointów API PoYo do wykonywania zadań i sprawdzania ich statusu.
models i describe odczytują publiczny katalog możliwości bez poświadczeń. Polecenia czatu, generowania, zadań, konta i płatnego wykonywania wymagają klucza API.
run domyślnie czeka 90 sekund. Przekroczenie limitu przerywa lokalne odpytywanie, ale nie anuluje zadania w backendzie. Kontynuuj poleceniem npx -y @poyoapi/cli task wait TASK_ID.
Przechowuj klucz w menedżerze sekretów CI i udostępnij go jako POYO_API_KEY. Przypnij @poyoapi/cli@VERSION dla powtarzalnych uruchomień, żądaj --format json i traktuj każdy niezerowy kod wyjścia jako błąd. Nigdy nie umieszczaj poświadczeń w historii poleceń ani w plikach repozytorium.
Nie. CLI wywołuje te same endpointy. describe pokazuje publiczną cenę wybranego modelu, a account — twoje bieżące saldo. run i submit są płatne; kredyty są pobierane tylko wtedy, gdy generowanie zakończy się powodzeniem. Kod 401 oznacza brak lub nieprawidłowy klucz, a 402 — że na koncie jest za mało kredytów.
Uruchamia most stdio, który przekazuje komunikaty JSON-RPC do https://api.poyo.ai/mcp. Wykonywanie modelu pozostaje w zdalnej usłudze PoYo.
Open source. Gotowe w każdym terminalu.
CLI na licencji MIT jest publikowane w npm i rozwijane na GitHubie. Najpierw przejrzyj publiczny katalog, a klucz API utwórz, gdy będziesz gotowy uruchomić model.