spicyapiDokumentacja
Konto i rozliczenia
Treść główna

Konsola i zespoły

Co robi każda strona konsoli SpicyAPI i kiedy z niej korzystać oraz jak zespoły dzielą klucze API i limity wydatków, gdy za wszystko płaci właściciel zespołu.

Konsola pod adresem spicyapi.ai/console to miejsce, w którym zarządzasz kontem w przeglądarce: pieniędzmi, kluczami API, logami, współpracownikami i ustawieniami. Twoje programy nigdy nie korzystają z konsoli. Wywołują API kluczem API.

Dopiero zaczynasz? Najpierw przejdź przez stronę Przygotuj konto: po kolei prowadzi przez rejestrację, doładowanie i utworzenie klucza. Ta strona opisuje całą resztę konsoli.

Programy używają kluczy API, a nie twojego logowania do konsoli

Nigdy nie kopiuj do kodu pliku cookie ani sesji z logowania do konsoli. Sesje logowania wygasają, są związane z twoją przeglądarką i nie mają limitów wydatków. Do wszystkiego, co działa automatycznie, utwórz klucz API. Zobacz Uwierzytelnianie.

Jak się poruszać

Na górze każdej strony: twoje saldo z przyciskiem Doładuj, Modele, Dokumentacja, dzwonek powiadomień oraz Znajdź stronę (naciśnij ⌘K w macOS albo Ctrl + K w Windows i Linuksie, a potem wpisz nazwę strony konsoli).

Po lewej jest pasek boczny. Na samej górze znajduje się przełącznik zakresu, który decyduje, jakie konto lub jaki zespół oglądasz (zobacz Zakres osobisty i zespoły). Pod nim strony są pogrupowane:

GrupaStrony
(bez nagłówka)Przegląd, Rozliczenia
Dla programistówKlucze API, Webhooki, Integracje, Logi
KontoZespół, Ustawienia, Powiadomienia, Ochrona danych
(na dole)Wsparcie

Na telefonie pasek boczny otworzysz przyciskiem menu.

Strony konsoli w skrócie

StronaAdresDo czego służy
Przegląd/consoleSaldo, ostatnia aktywność i lista pierwszych kroków
Rozliczenia/console/billingDoładowanie konta, automatyczne doładowanie, historia salda, zużycie, wystawianie faktur
Klucze API/console/keysTworzenie, ograniczanie i unieważnianie kluczy
Webhooki/console/webhooksKlucz podpisujący callbacki i podgląd dostarczeń
Integracje/console/integrationsKonfiguracja do skopiowania dla SDK, CLI, serwera MCP i innych narzędzi
Logi/console/logsWyszukanie dowolnego zadania: status, koszt, błędy, wyniki
Zespół/console/teamTworzenie zespołów, zapraszanie osób, limity wydatków zespołu
Ustawienia/console/settingsProfil, hasło, uwierzytelnianie dwuskładnikowe, urządzenia, język błędów API, zamknięcie konta
Powiadomienia/console/notificationsAlert o niskim saldzie, nowości w modelach, wybór e-maili, które dostajesz
Ochrona danych/console/settings/dataSkrócenie przechowywania wyników, promptów i przesłanych plików; pobranie danych
Wsparcie/console/supportPrywatna rozmowa z naszym zespołem wsparcia

Wszystkie adresy zaczynają się od https://spicyapi.ai. Adresy konsoli nie mają prefiksu języka.

Co robi każda strona

Przegląd

Pierwsza strona po zalogowaniu.

  • Lista Pierwsze kroki: Zweryfikuj adres e-mail, Doładuj konto, Uruchom pierwsze zadanie, a do tego linki do pracy z API albo tworzenia bez kodu. Gdy skończysz, schowaj ją przyciskiem Ukryj pierwsze kroki.
  • Dostępne saldo wraz z kwotą zarezerwowaną na wciąż trwające zadania i tym, co wydano w ostatnich 7 dniach.
  • Żądania z ostatnich 7 dni i Błędy z ostatnich 7 dni, z linkami Sprawdź zużycie i Zobacz logi.
  • Ostatnio używane modele i Ostatnie zadania.
  • Ostrzeżenie, gdy saldo jest niskie albo puste. Przy pustym saldzie nowe zadania są odrzucane, dopóki nie doładujesz konta; zadania już przyjęte kończą się normalnie.

Rozliczenia

Rozliczenia mają trzy karty: Przegląd, Zużycie i Faktury.

Rozliczenia → Przegląd (/console/billing)

  • Doładuj konto kartą, kryptowalutami albo – jeśli jest dostępny – przelewem ręcznym. Instrukcję krok po kroku, czas oczekiwania i to, co zrobić, gdy płatność się nie pojawia, znajdziesz w Przygotuj konto → Doładuj konto.
  • Zlecenia doładowania: każde doładowanie z jego statusem (Oczekuje, Opłacone, Anulowane, Zwrócone). Otwórz oczekujące zlecenie ręczne przyciskiem Dokończ płatność, żeby zobaczyć instrukcję płatności i podać numer referencyjny transakcji, albo wybierz Anuluj oczekujące zlecenie, jeśli płatność nie została wysłana.
  • Automatyczne doładowanie: zapisz kartę i pozwól nam doładowywać konto, gdy saldo się kończy. Dokładne zasady, w tym to, co się dzieje, gdy obciążenie się nie powiedzie, opisuje Przygotuj konto → Automatyczne doładowanie.
  • Szczegóły salda: widoczne tylko wtedy, gdy twoje konto ma środki promocyjne albo zatwierdzony kredyt. Każda partia środków promocyjnych jest wymieniona z terminem ważności.
  • Historia salda: każdy ruch pieniędzy, od najnowszych. Filtruj według rodzaju i zakresu dat albo użyj Eksportuj CSV. Typowe wpisy to Doładowanie, Bonus, Zarezerwowane (kwota odłożona w chwili przyjęcia zadania), Obciążenie (ostateczna cena udanego zadania), Rezerwacja zwolniona (zwrot niewykorzystanej części blokady) i Zwrot (cała blokada oddana po niepowodzeniu albo przekroczeniu czasu). Jak działają opłaty, opisuje strona Rozliczenia.

Rozliczenia → Zużycie (/console/billing/usage)

Zadania i wydatki dzień po dniu, na wykresie, z ostatnich 7, 30 lub 90 dni albo z własnego zakresu do 92 dni (dni liczone w UTC). Pod wykresem jest sekcja Według modelu: zadania, niepowodzenia, wydatki i udział każdego modelu, z przyciskiem Pokaż zadania, który przenosi do tych zadań w Logach. Eksportuj CSV pobiera widoczne sumy dzienne. Endpoint zużycia w API raportuje tylko klucz, który go wywołuje; ta strona pokazuje cały zakres wybrany w pasku bocznym.

Rozliczenia → Faktury (/console/billing/invoices)

Wpisz dane do faktury, wystaw fakturę za opłacone doładowanie albo zestawienie zużycia za zamknięty miesiąc i twórz miesięczne Zestawienia konta (CSV). Czym różnią się te dokumenty i jak poprawić któryś z nich, opisuje Przygotuj konto → Faktury i potwierdzenia.

Klucze API

Twórz, edytuj i unieważniaj klucze, z których korzystają twoje programy. Lista pokazuje dla każdego klucza zamaskowaną wartość, dotychczasowe wydatki, limity, dozwolone modele, listę dozwolonych IP, datę wygaśnięcia i czas ostatniego użycia. Szukaj po nazwie albo zamaskowanym kluczu i filtruj według statusu: Aktywny, Wygasły lub Unieważniony.

  • Utwórz klucz tworzy klucz w zakresie wybranym w pasku bocznym. Pełny klucz jest pokazywany tylko raz.
  • Edytuj zmienia nazwę, limity wydatków (dzienny, miesięczny, łączny), dozwolone modele, listę dozwolonych IP i datę wygaśnięcia. Przy edycji puste pole limitu oznacza brak limitu.
  • Unieważnij natychmiast zatrzymuje klucz i nie da się tego cofnąć. Zadania już przyjęte działają dalej i są rozliczane.
  • Klucz oznaczony Zarządzane przez SpicyAPI jest używany przez serwis, gdy uruchamiasz model z jego strony.

Każde pole wyjaśnia Przygotuj konto → Utwórz klucz API. Kody błędów zwracane przez każde ograniczenie opisuje strona Uwierzytelnianie.

W zespole: klucze zespołu możesz tworzyć i nimi zarządzać tylko z rolą Właściciel, Administrator albo Programista. Zużycie i limity klucza zespołu liczą się do zespołu, a jego zadania opłaca właściciel zespołu.

Webhooki

Webhook to wiadomość, którą SpicyAPI wysyła do twojego własnego serwera, gdy zadanie się zakończy, żeby nie trzeba było ciągle o nie pytać. Adres wybierasz dla każdego zadania w polu callBackUrl. Ta strona robi dwie rzeczy.

Klucz podpisujący webhooki. Każdy callback jest podpisany, więc twój serwer może sprawdzić, że naprawdę pochodzi od SpicyAPI. Twoje konto ma jeden klucz podpisujący, wspólny dla wszystkich jego kluczy API, a jego wartość jest pokazywana tylko raz, w chwili utworzenia. Nowe konta mają już klucz, którego nikt nie widział, więc karta może pokazywać Skonfigurowany, choć nie masz czego skopiować:

  1. Wybierz Wygeneruj (jeśli karta pokazuje Nie ustawiono) albo Wymień (jeśli pokazuje Skonfigurowany).
  2. Skopiuj nowy klucz do ustawień swojego serwera, zwykle jako SPICY_WEBHOOK_SECRET.
  3. Wybierz Klucz jest zapisany.

Wymiana klucza nie ma okresu przejściowego

Stary klucz przestaje podpisywać w chwili wymiany, a nowy działa od razu. Dopóki twój serwer nie ma nowego klucza, nie zweryfikuje ani jednego callbacku, łącznie z ponowieniami wcześniejszych dostarczeń. Wymieniaj klucz w spokojnym okresie i od razu zaktualizuj serwer. Utracone wyniki nadal można pobrać przez recordInfo. Zobacz Webhooki.

Dostawy webhooków. Każda próba wysłania callbacku dla twojego konta, od najnowszych, z filtrami Dostarczone, Ponawiane i Nieudane, liczbą prób i czasem kolejnej próby. Ponów wysyła pierwotną, podpisaną wiadomość jeszcze raz; upewnij się, że twój serwer bezpiecznie przyjmie tę samą wiadomość dwa razy. Dostarczenia, którego zapisana treść została już wyczyszczona zgodnie z twoimi ustawieniami przechowywania, nie da się ponowić.

Integracje

Konfiguracja do skopiowania i wklejenia dla narzędzi współpracujących ze SpicyAPI. Wybierz narzędzie, żeby zobaczyć jego konfigurację i przycisk Otwórz dokumentację.

  • Podstawy połączenia: adres bazowy dla klientów zgodnych z OpenAI i skrót Utwórz klucz. Nazwij klucz po narzędziu, które będzie z niego korzystać.
  • Narzędzia oficjalne: SDK dla TypeScriptu, CLI, serwer MCP i Agent Skill.
  • Klienci zgodni z OpenAI: narzędzia, w których można zmienić adres bazowy, dla modeli tekstowych i wideo. Generowania obrazów nie ma na endpointach zgodnych.
  • Agenci programistyczni: edytory i agenci, do których dodaje się serwer MCP, a ten prosi cię o potwierdzenie każdej opłaty.

Fragmenty kodu używają symbolu zastępczego MODEL_ID_FROM_CATALOG: zastąp go dokładnym identyfikatorem modelu z katalogu na żywo (GET /api/v1/models, spicyapi models list albo listModels()). Zobacz Modele.

Logi

Każde zadanie, od najnowszych, także nieudane. Każdy wiersz pokazuje zadanie, model, status, czas trwania i koszt.

  • Filtry: status, model i zakres dat. Pole wyszukiwania przyjmuje dokładne ID zadania albo ID żądania – to najszybszy sposób, żeby znaleźć zadanie stojące za zgłoszonym błędem. Na stronie wczytuje się do 500 wierszy; żeby zobaczyć więcej, zawęź filtry.
  • Eksportuj CSV eksportuje każde zadanie pasujące do filtrów: domyślnie z ostatnich 30 dni, najwyżej z 92 dni lub 10 000 wierszy.
  • Otwórz szczegóły przy zadaniu pokazuje jego stan, koszt, czas rozpoczęcia i zakończenia, użyty klucz, ID zadania i ID żądania, kod błędu i sekcję Dlaczego się nie powiodło, parametry żądania, odpowiedź oraz linki do pobrania (Pobierz link; każdy link wygasa, a w razie potrzeby wygenerujesz nowy).

Pole kosztu pokazuje zablokowaną kwotę podczas wykonywania zadania, a po rozliczeniu faktyczną opłatę. Nieudane zadanie może być płatne przy odmowie dotyczącej treści wyraźnie wskazanej na stronie modelu. Sprawdź rozliczenie zamiast wnioskować o zwrocie na podstawie stanu.

W szczegółach zadania są trzy akcje:

AkcjaCo robiPieniądze
Ponów jako nowe zadanieUruchamia te same dane wejściowe jeszcze raz jako nowe zadanie. Tylko dla zadań, które się nie powiodły, przekroczyły czas albo zostały anulowane, i tylko dopóki ich dane wejściowe są przechowywaneNowa opłata. Pierwotny zapis pozostaje bez zmian
Trwale usuń wynikiUsuwa obrazy, wideo i tekst wytworzone przez zadanie, jego zapisany wynik i wysłany prompt. Nie da się tego cofnąćNic się nie zmienia: koszt, model, stan, znaczniki czasu i ID żądania zostają w zapisie
Usuń z historiiCzyści żądanie i wynik zadania, kolejkuje jego media do usunięcia i ukrywa wiersz w logach. Dostępne, gdy zadanie się zakończyło i zostało rozliczoneNic się nie zmienia: zapisy rozliczeniowe zostają

Żadna z nich nie anuluje trwającego zadania: przyjętych zadań nie da się anulować. Co usuwanie zachowuje, a co usuwa, opisuje strona Przechowywanie i usuwanie danych.

W zespole: każdy członek widzi zadania zespołu ze statusem i kosztem. Prompty, wyniki i linki do pobrania widzą tylko role Właściciel, Administrator i Programista. Trzy powyższe akcje są dostępne wyłącznie dla konta, które zapłaciło za zadanie.

Zespół

Twórz zespoły, zapraszaj osoby, zmieniaj role, ustawiaj limity wydatków zespołu, opuszczaj zespół albo go przekazuj. Pracujesz w pojedynkę? Zespół nie jest ci potrzebny: twoje klucze, saldo i zużycie działają samodzielnie. Wszystko o zespołach znajdziesz niżej, w sekcji Zespoły.

Ustawienia

Jedna strona, podzielona na grupy.

Konto

  • E-mail z oznaczeniem Zweryfikowany albo Niezweryfikowany. Adres do logowania zmienisz przez Zmień adres e-mail do logowania: wysyłamy link potwierdzający na nowy adres (ważny 20 minut) i ostrzeżenie na stary. Potrzebne jest obecne hasło.
  • Nazwa wyświetlana, ID konta (podawaj je w kontakcie ze wsparciem) i Konto od.

Bezpieczeństwo

  • Hasło. Jego zmiana wylogowuje wszystkie urządzenia. Konto utworzone przez Google albo GitHub nie ma hasła, dopóki nie wybierzesz Wyślij link e-mailem i go nie ustawisz; hasło jest potrzebne do zamknięcia konta albo przekazania zespołu.
  • Zalogowane urządzenia. Użyj Wyloguj przy każdym urządzeniu, którego nie rozpoznajesz, albo Wyloguj wszędzie (łącznie z tym urządzeniem), jeśli podejrzewasz, że ktoś inny ma dostęp. Zaraz potem zmień hasło.
  • Uwierzytelnianie dwuskładnikowe. Wybierz Skonfiguruj 2FA, wpisz obecne hasło, dodaj konto do aplikacji uwierzytelniającej i wpisz sześciocyfrowy kod z tej aplikacji. Od tej chwili każde logowanie prosi o kod. Dostajesz też dziesięć jednorazowych kodów odzyskiwania: przechowuj je gdzie indziej niż na telefonie, bo bez telefonu to jedyna droga powrotu do konta, a drugi raz nie da się ich wyświetlić. Nowe kody odzyskiwania zastępuje wszystkie dotychczasowe; Wyłącz 2FA usuwa to zabezpieczenie. Obie opcje najpierw proszą o potwierdzenie tożsamości.
  • Aktywność zabezpieczeń: ostatnie logowania, nowe urządzenia i zmiany danych logowania.

Preferencje

  • Język błędów API: język pola msg w odpowiedziach z błędem i pola errorMessage zadania (przy sprawdzaniu stanu i w webhookach) dla żądań wysyłanych twoimi kluczami API. Domyślnie jest to angielski. Pierwszeństwo ma własny nagłówek Accept-Language żądania, a kody, po których należy rozgałęziać logikę (code, errorCode), nigdy się nie zmieniają. Zobacz Błędy.

Rozliczenia i dane

  • Skróty do Dane rozliczeniowe i zestawienia (w Rozliczenia → Faktury) oraz Dane i prywatność (strona Ochrona danych).

Strefa ryzyka: Zamknij konto

Zamknięcie konta wylogowuje wszystkie urządzenia, trwale unieważnia wszystkie klucze API i usuwa wygenerowane media oraz przechowywaną treść zadań. Zapisy rozliczeniowe, audytowe i uzgodnieniowe są zachowywane, tak jak opisuje to Polityka prywatności. Porzucone zlecenia doładowania, których nigdy nie opłaciłeś, są anulowane za ciebie. Zamknięcie czeka tylko wtedy, gdy:

  • zadania są w kolejce lub w toku albo zakończone zadania są jeszcze rozliczane (zwykle w ciągu minuty);
  • płatność za doładowanie jest nadal przetwarzana (znika sama, gdy operator płatności ją potwierdzi lub zwolni, zwykle w ciągu kilku minut; jeśli po godzinie nadal tam jest, skontaktuj się z pomocą techniczną);
  • konto jest winne pieniądze (wykorzystany przyznany kredyt albo ujemne saldo), co wyrównujesz doładowaniem;
  • zespół, którego jesteś właścicielem, trzeba jeszcze przekazać innemu członkowi albo usunąć z niego pozostałych członków.

Konsola wymienia wszystko, co jeszcze blokuje zamknięcie. Potwierdzasz obecnym hasłem albo, jeśli zarejestrowałeś się przez Google lub innego dostawcę logowania i nie masz hasła, 6-cyfrowym kodem, który wyślemy ci e-mailem (ważny 15 minut).

Zamknięcie konta oznacza utratę salda

Saldo pozostałe na koncie przepada. Nie jest zwracane ani wypłacane w gotówce, a konsola prosi o wyraźne potwierdzenie tego faktu. Jeśli wolisz, najpierw je wykorzystaj. Zobacz zasady zwrotów.

Powiadomienia

  • Alert o niskim saldzie. Włącz go i wybierz próg ($5, $10, $25, $50 albo $100). Gdy dostępne saldo spadnie poniżej progu, dostaniesz jeden alert w dzwonku powiadomień, a do tego e-mail, jeśli konto ma adres e-mail. Kolejny alert przyjdzie dopiero wtedy, gdy saldo wróci do progu lub powyżej, a potem znów spadnie poniżej. Saldo jest sprawdzane mniej więcej co 10 minut.
  • Nowości w obserwowanych modelach. Obserwuj model z jego strony na spicyapi.ai; Zarządzaj otwiera listę obserwowanych modeli i nowości w produkcie.
  • Dostarczanie. Alerty w aplikacji są zawsze włączone. E-maile Nowości w produkcie oraz Oferty i ogłoszenia można włączyć lub wyłączyć. Powiadomienia dotyczące bezpieczeństwa, rozliczeń i spraw krytycznych dla działania usługi są wysyłane zawsze.

Ochrona danych

  • Przechowywanie: trzy osobne zegary dla kategorii Wygenerowane wyniki, Tekst promptów i Przesłane pliki. Możesz je tylko skrócić względem maksimów platformy (14 dni dla wyników, 30 dni dla tekstu promptów, 24 godziny dla przesłanych plików). Skrócenie zegara może przy najbliższym czyszczeniu usunąć treść zadań, które już zostały wykonane, a czyszczenie rusza w ciągu minuty. Przed potwierdzeniem konsola zlicza, czego zmiana dotknie, a usuniętej treści nie da się przywrócić. Najpierw pobierz wszystko, co chcesz zachować.
  • Przechowywanie treści zadań: starsza karta z dwoma ustawieniami. Przechowuj treść zadań pokazuje w dniach, jak długo przechowywana jest treść zadań; czas ustawiasz trzema zegarami opisanymi wyżej. Czyść treść wkrótce po zakończeniu czyści treść zakończonego zadania mniej więcej godzinę po zapisaniu jego wyników i dostarczeniu webhooka.
  • Dokąd trafiają Twoje dane: podsumowanie zobowiązań z Polityki prywatności, w tym tego, że twoje dane wejściowe i wyniki nie służą do trenowania modeli.
  • Pobierz swoje dane: plik JSON z profilem, rolami w zespołach, szczegółami kluczy API (nigdy samymi kluczami), przechowywanymi danymi zadań i zapisami rozliczeniowymi. Pliki mediów nie są dołączane, więc wyniki pobierz osobno.

Pełne zasady, w tym ustawienie dla pojedynczego żądania i to, co zostaje po usunięciu, opisuje strona Przechowywanie i usuwanie danych.

Wsparcie

Rozpocznij prywatną rozmowę, którą możesz przeczytać tylko ty i wsparcie SpicyAPI. Wybierz Nowa rozmowa, wpisz temat, zaznacz, czego dotyczy sprawa (Konto, Rozliczenia, Integracja z API, Zadanie lub wynik, Prywatność, Rozwiązania firmowe albo Coś innego), i opisz, co się stało. Odpowiedzi pojawiają się w rozmowie (status Czeka na wsparcie, Czeka na Ciebie, Rozwiązane albo Zamknięte) i w dzwonku powiadomień.

Pomóż nam szybko ci pomóc: podaj identyfikator zadania, request_id z odpowiedzi z błędem albo ID zlecenia doładowania oraz przybliżony czas zdarzenia (UTC). Nigdy nie wklejaj klucza API, hasła ani danych karty. Możesz też napisać na support@spicyapi.ai.

Zespoły

Zakres osobisty i zespoły

Każde konto ma zakres Osobisty. Nie ma w nim nikogo więcej i jeśli pracujesz w pojedynkę, niczego więcej nie potrzebujesz: twoje osobiste klucze, saldo i zużycie działają bez zespołu.

Zespół pozwala współpracownikom dzielić klucze API, widzieć tę samą historię zadań i pracować w ramach wspólnych limitów wydatków. Każdy zespół ma własnych członków, własne klucze i własne limity.

Przełącznik zakresu na górze paska bocznego decyduje, co pokazuje konsola:

  • Osobisty: tylko twój własny zakres.
  • Nazwa zespołu: tylko klucze, zadania, zużycie i aktywność tego zespołu.
  • Wszystkie zakresy: wszystko, do czego masz dostęp, razem.
  • Nowy zespół: skrót do utworzenia zespołu.

Przełącznik decyduje też o tym, gdzie trafi nowy klucz API: klucz utworzony, gdy wybrany jest zespół, należy do tego zespołu.

Kto płaci za zespół

Każde zadanie wysłane kluczem API zespołu jest opłacane z salda właściciela zespołu. To najważniejsza zasada dotycząca zespołów.

  • Członkowie nigdy nie doładowują zespołu i nigdy nie widzą salda właściciela, jego doładowań, danych płatniczych ani faktur.
  • Jeśli jesteś członkiem, a klucz zespołu zaczyna zwracać 40201, konto musi doładować właściciel.
  • Twoje osobiste klucze, saldo i zużycie nigdy nie są udostępniane zespołowi, do którego dołączasz, a opuszczenie zespołu ich nie dotyczy.
  • Właściciel, administrator albo programista może tworzyć klucze zespołu, które wydają saldo właściciela. Wskazówka dla właściciela: ustaw limity wydatków zespołu i nadaj kluczom własne limity.

Utwórz zespół

  1. Otwórz stronę Zespół i wybierz Załóż zespół (albo Nowy zespół w przełączniku zakresu).
  2. Wpisz nazwę zespołu (do 120 znaków) i wybierz Utwórz zespół.

Otrzymujesz w zespole rolę Właściciel. Jedno konto może być właścicielem najwyżej 10 przestrzeni roboczych, a twój zakres Osobisty liczy się jako jedna z nich, więc możesz utworzyć do dziewięciu zespołów. Liczba zespołów innych osób, do których możesz dołączyć, nie jest ograniczona.

Zaproś osoby

Zapraszać może tylko Właściciel albo Administrator.

Wyślij zaproszenie

Otwórz zespół, wybierz Zaproś współpracownika, wpisz adres tej osoby w polu E-mail zapraszanej osoby, wybierz rolę w polu Rola (zobacz Role i uprawnienia; podsumowanie pokazuje Co może każda z ról?) i wybierz Wyślij zaproszenie.

Co powinno się pojawić: zaproszenie na liście ze statusem Oczekuje, z oznaczeniem Zaproszenie wysłane albo Zaproszenie niewysłane i datą wygaśnięcia. Konsola pokazuje też jednorazowy token zaproszenia.

Co się właśnie stało: wysłaliśmy link e-mailem na ten adres. Zaproszenie jest ważne 7 dni.

Jeśli e-mail nie wyszedł

Jeśli lista pokazuje Zaproszenie niewysłane albo e-mail w ogóle nie dociera, przekaż jednorazowy token zaufanym, prywatnym kanałem. Token jest pokazywany tylko raz. Wybierz Wyślij ponownie, żeby wysłać nowy e-mail i dostać nowy token: ponowne wysłanie unieważnia poprzedni link i token i rozpoczyna nowy, 7-dniowy okres.

Zaproszona osoba przyjmuje zaproszenie

Otwiera link z e-maila i loguje się – albo najpierw zakłada konto – dokładnie tym adresem e-mail, na który wysłano zaproszenie, a potem wybiera Przyjmij zaproszenie. Oczekujące zaproszenie pojawia się też na stronie Zespół tej osoby, w sekcji Zaproszenia dla Ciebie, z przyciskiem Dołącz do zespołu, a token można wkleić w sekcji Masz token zaproszenia?.

Co ta osoba powinna zobaczyć: komunikat Już jesteś w środku, a zespół pojawia się w jej przełączniku zakresu.

Zasady zaproszeń:

  • Zaproszenie może przyjąć tylko konto, którego adres e-mail zgadza się z zaproszonym adresem. Przy innym adresie pojawia się komunikat Please sign in with the invited email address to accept this invite.
  • Konta prywatne (tryb „Prywatne, w pełni po twojej stronie”) nie mogą dołączać do zespołów, bo nie mają adresu e-mail.
  • Na jeden adres e-mail w danym zespole może czekać tylko jedno zaproszenie. Osoby, która już jest członkiem, nie można zaprosić ponownie.
  • Zespół może mieć do 100 członków, łącznie z właścicielem.
  • Unieważnij w każdej chwili anuluje oczekujące zaproszenie; tę samą osobę możesz później zaprosić ponownie.
  • Wygasłego zaproszenia nie da się przyjąć. Wyślij nowe.

Role i uprawnienia

W konsoli role mają poniższe nazwy. API i eksporty używają nazw pisanych małymi literami, podanych w nawiasach.

Co może członekWłaściciel (owner)Administrator (admin)Programista (developer)Menedżer budżetu (billing)Tylko odczyt (readonly)
Widzieć zadania zespołu, ich status, koszt i zużycieTakTakTakTakTak
Czytać prompty i wyniki, generować linki do pobraniaTakTakTakNieNie
Widzieć Aktywność zespołu (ruchy pieniędzy z zadań zespołu)TakTakNieTakNie
Tworzyć, edytować i unieważniać klucze API zespołuTakTakTakNieNie
Używanie zasobów w generowaniu (biblioteka zespołu)TakTakTakTakTak
Zapis do biblioteki zasobów zespołuTakTakTakNieNie
Zmiana nazwy lub usuwanie zasobów zespołuTakTakTylko własne zapisyNieNie
Zmieniać limity wydatków zespołuTakTakNieTakNie
Zapraszać osoby, ponownie wysyłać lub unieważniać zaproszeniaTakTak, ale nie może zapraszać administratorówNieNieNie
Zmieniać role i usuwać członkówTakTak, ale nie innych administratorów i nie może nikomu nadać roli administratoraNieNieNie
Zmieniać nazwę zespołuTakTakNieNieNie
Przekazać własnośćTakNieNieNieNie
Opuścić zespółNie, najpierw musi przekazać własnośćTakTakTakTak

Ponadto:

  • Nikt nie może zmienić własnej roli. Rola właściciela zmienia się wyłącznie przez przekazanie własności.
  • Ponowić zadanie, trwale usunąć jego wyniki albo usunąć je z historii może wyłącznie konto, które za nie zapłaciło, niezależnie od roli.
  • Członek z rolą, która nie pozwala czytać treści, widzi komunikat Twoja rola pozwala widzieć status zadań i zużycie, ale nie prompty ani wyniki.
  • Nikt poza właścicielem nigdy nie widzi jego osobistego salda, doładowań, danych płatniczych ani faktur. Aktywność zespołu wymienia tylko ruchy pieniędzy spowodowane zadaniami zespołu.

Limity wydatków zespołu

Każdy zespół (i twój zakres Osobisty) ma limit dzienny i miesięczny w dolarach amerykańskich, w sekcji Zespół → twój zespół → Limity wydatków. Właściciele, administratorzy i menedżerowie budżetu mogą je zmienić przyciskiem Edytuj, a potem Zapisz limity.

  • Obejmują łącznie wszystkie zadania wysłane kluczami tego zakresu.
  • Liczą się zarówno kwoty już pobrane, jak i kwoty zarezerwowane na wciąż trwające zadania.
  • Limit dzienny odnawia się o 00:00 UTC, a miesięczny – pierwszego dnia każdego miesiąca o 00:00 UTC.
  • Domyślnie jest ustawione Bez limitu. Wpisz 0, żeby znieść limit. Pozostawienie pustego pola zachowuje jego obecną wartość.
  • Zadanie, które przekroczyłoby limit, jest odrzucane z kodem 40202 i komunikatem Workspace daily budget has been reached albo Workspace monthly budget has been reached. Nic nie zostaje utworzone ani zarezerwowane.

Limity zespołu obowiązują dodatkowo, obok dziennych, miesięcznych i łącznych limitów każdego klucza oraz salda właściciela. Zadanie zatrzymuje to, co wyczerpie się pierwsze. Wszystkie limity wydatków opisuje strona Rozliczenia.

Zmiana ról i usuwanie członków

Otwórz zespół. W sekcji Członkowie wybierz członkowi nową rolę i potwierdź przyciskiem Zmień rolę; zmiana działa natychmiast. Usuń od razu wyłącza członka z zespołu: traci dostęp do zespołu, jego kluczy i jego aktywności. Właściciela nie da się usunąć.

Usunięcie członka nie unieważnia kluczy, które ta osoba utworzyła lub których używała. Klucze zespołu należą do zespołu, więc każdy klucz, który ta osoba nadal ma, unieważnij na stronie Klucze API.

Opuszczenie zespołu

Każdy członek poza właścicielem może odejść: otwórz zespół, wybierz Opuść zespół i potwierdź. Dostęp kończy się natychmiast, a wrócić można tylko z nowym zaproszeniem.

Nic nie jest usuwane. Klucze, zadania i zużycie zespołu zostają przy zespole i nadal obciążają jego właściciela. Jeśli wciąż masz któryś z jego kluczy, poproś administratora o jego unieważnienie. Twój zakres osobisty pozostaje nienaruszony.

Właściciel nie może po prostu odejść, bo klucze zespołu dalej wydawałyby jego pieniądze, a nikt nie mógłby nimi zarządzać. Najpierw przekaż własność. Jeśli jesteś jedynym członkiem, zaproś kogoś i przekaż mu zespół.

Przekazanie własności

Przekazać własność może tylko właściciel i tylko osobie, która już jest członkiem zespołu.

  1. Otwórz zespół i przejdź do Strefa ryzyka → Przekaż własność.
  2. Wybierz osobę w polu Nowy właściciel i wpisz Obecne hasło. (Konto utworzone przez Google albo GitHub musi najpierw ustawić hasło w sekcji Ustawienia.)
  3. Sprawdź dane i wybierz Przekaż zespół.

Od tej chwili:

  • saldo nowego właściciela opłaca każde zadanie wysłane kluczami zespołu, a wszystkie klucze zespołu przechodzą na konto nowego właściciela;
  • otrzymujesz rolę Administrator;
  • zadania przyjęte przed przekazaniem zachowują pierwotne rozliczenie i nie są anulowane.

Usuwanie zespołu

Zespołu nie da się usunąć. Nieużywany zespół nic nie kosztuje i nigdy nie pojawia się na rachunku. Usuń z niego członków i zostaw go bez użytku albo zmień jego nazwę i wykorzystaj go ponownie, zamiast tworzyć kolejny.

Limity zespołów w skrócie

LimitWartość
Przestrzenie robocze, których właścicielem może być jedno konto10, łącznie z zakresem Osobisty
Członkowie w zespole100, łącznie z właścicielem
Ważność zaproszenia7 dni; ponowne wysłanie rozpoczyna nowy, 7-dniowy okres
Aktywne klucze API w jednym zakresie50
Nazwa zespołuOd 1 do 120 znaków

Na tej stronie