Bot na Telegram i Discord

Bot SpicyAPI to mały program, który uruchamiasz sam. Łączy się z Telegramem (a jeśli chcesz, także z Discordem) i pozwala osobom, którym na to pozwolisz, generować obrazy, tworzyć wideo, zamieniać obrazy w wideo i rozmawiać z postaciami, które zdefiniujesz. Wszystko jest opłacane z twojego własnego salda SpicyAPI, a każde żądanie jest wyceniane, zanim cokolwiek zostanie pobrane.

Bot jest bezpłatny i ma otwarty kod (MIT): github.com/spicyapi-ai/spicyapi-bot. Domyślnie jest prywatny: dopóki nie dopuścisz innych osób lub grup, możesz z niego korzystać tylko ty.

Co robi bot

• Obrazy: /pic a lighthouse at dusk
• Wideo: /vid waves rolling onto a beach at sunset
• Animate: dotknij Animate pod dowolnym obrazem stworzonym przez bota albo odpowiedz na niego poleceniem /animate <jak ma się poruszać>.
• Czat z postacią: pisz na czacie prywatnym albo użyj /talk. Odpowiedzi spływają strumieniem do jednej wiadomości.
• Ochrona wydatków: każde żądanie jest najpierw wyceniane (wyceny są bezpłatne), drogie wymagają dotknięcia Confirm, a dzienne limity na osobę i na cały bot są egzekwowane.
• Domyślnie prywatny: nikt inny nie może go używać, dopóki go nie dopuścisz.

Katalog SpicyAPI zawiera modele bez cenzury, które nie dodają własnego filtra treści, a bot działa z dowolnym wybranym modelem. Prawo i polityka treści SpicyAPI nadal obowiązują wszystko, co generujesz. Zobacz Treści i odpowiedzialność za korzystanie.

Polecenia

Nazwy celowo nie brzmią /image, /video ani /chat, których używają inne popularne boty, dzięki czemu ten bot może dzielić grupę z nimi. W grupie na Telegramie odpowiedz na jedną z wiadomości czatu bota, aby dalej rozmawiać z postacią.

Zanim zaczniesz

• Komputer lub serwer, który stale działa, z zainstalowanym Dockerem. (Albo konto Railway, patrz niżej.)
• Konto SpicyAPI z saldem. Zobacz Przygotuj konto i Rozliczenia.
• Konto na Telegramie, aby utworzyć bota przez BotFather.

Wdrożenie przez Docker Compose

git clone https://github.com/spicyapi-ai/spicyapi-bot.git
cd spicyapi-bot
cp .env.example .env

SPICY_API_KEY=sk-spicy-...
TELEGRAM_BOT_TOKEN=123456789:AA...
OWNER_ID=your-telegram-user-id

docker compose up -d

docker compose up -d --build
docker compose logs -f

Aby później zaktualizować bota, uruchom git pull && docker compose up -d --build.

Wdrożenie na Railway

Railway może uruchomić bota bez własnego serwera. Nie ma szablonu na jedno kliknięcie: wdrażasz z własnej kopii repozytorium.

Zostaw usługę na jednej replice: dwie kopie odpytujące ten sam token Telegrama walczą o aktualizacje. Bot nie potrzebuje publicznej domeny ani otwartego portu.

Dodaj Discorda (opcjonalnie)

Discord nie dopuszcza aplikacji z poleceniami objętymi ograniczeniem wiekowym w swoim App Directory, więc zostaw bota prywatnego. .env.example zawiera też DISCORD_MEDIA_IN_DMS, domyślnie false: obrazy i wideo działają wtedy tylko na kanałach serwera z ograniczeniem wiekowym, a nie w wiadomościach prywatnych.

Kto może z niego korzystać

Obcy, którzy znajdą bota, dowiadują się, że jest prywatny, i dostają swój identyfikator użytkownika, który mogą ci przesłać. Grupy są ignorowane, dopóki nie znajdą się w ALLOWED_CHAT_IDS; gdy grupa jest na liście, z bota może korzystać każdy jej członek, w granicach dziennych limitów. Identyfikatory grup na Telegramie są ujemne, na przykład -1001234567890.

To ty prowadzisz tego bota i odpowiadasz za to, komu pozwalasz z niego korzystać. Obowiązuje regulamin SpicyAPI, w tym regiony, w których SpicyAPI nie świadczy usług.

Jak działają wydatki

1. Najpierw cena. Każdy obraz lub wideo jest wyceniany przez SpicyAPI, zanim cokolwiek się wydarzy. Wyceny są bezpłatne.
2. Twardy pułap. Jeśli żądanie mogłoby kosztować więcej niż MAX_COST_PER_REQUEST_USD (domyślnie $1), jest odrzucane. Nic nie jest pobierane.
3. Potwierdzenie. Jeśli mogłoby kosztować więcej niż CONFIRM_ABOVE_USD (domyślnie $0.10), bot pokazuje cenę z przyciskami Confirm i Cancel. Potwierdzić może tylko osoba, która o to poprosiła.
4. Dzienne limity. Każda osoba może wydać USER_DAILY_BUDGET_USD (domyślnie $1) na dobę UTC, a cały bot DAILY_BUDGET_USD (domyślnie $5). Generowania, które jeszcze trwają, liczą się jako wydane do zakończenia, więc kilka żądań naraz nie przemknie obok limitu. Właścicieli obowiązuje tylko limit całego bota.
5. Brak podwójnych opłat. Każde żądanie niesie klucz idempotentności wyprowadzony z wiadomości czatu albo dotknięcia przycisku, więc zduplikowana aktualizacja Telegrama albo podwójne dotknięcie zwraca zadanie, które już istnieje.
6. Wyniki. Postęp jest pokazywany przez edytowanie jednej wiadomości co kilka sekund. Wynik pokazuje faktyczną opłatę i identyfikator zadania, który znajdziesz w sekcji Logs w konsoli.

Przyjętego generowania nie można anulować. Udane uruchomienia są płatne, a zwykłe niepowodzenia zwalniają rezerwację. Niektóre odmowy treści są płatne wyłącznie wtedy, gdy strona modelu mówi o tym wprost. Zobacz Rozliczenia.

Użyj klucza z limitem

Bot prowadzi własny rejestr w DATA_DIR/state.json. Jeśli ten plik zginie, bot zapomina, ile wydano dzisiaj. Limit na kluczu API w konsoli to limit, którego nie da się stracić, bo egzekwuje go SpicyAPI. Utwórz osobny klucz dla bota, ustaw dzienny limit wydatków i opcjonalnie dopuść tylko modele, które chcesz. Gdy limit zostanie osiągnięty, bot informuje, że klucz osiągnął limit wydatków.

Inne przydatne ustawienia:

Modele i ceny

Każda osoba może zmienić swoje modele poleceniem /models. Operator ustawia wartości domyślne:

Dokładne identyfikatory modeli są w .env.example; aby zmienić model, skopiuj inny identyfikator z aktualnego katalogu (GET /api/v1/models; w przykładzie postaci poniżej MODEL_ID_FROM_CATALOG oznacza miejsce, w które taki identyfikator trafia). Ceny pochodzą z publicznego katalogu i mogą się zmieniać; bot zawsze pokazuje aktualną wycenę. Modele przeglądasz na spicyapi.ai/models albo w Katalogu modeli i schematach. Do roleplay ranking roleplay pomaga wybrać model czatu.

Postacie

Postacie znajdują się w pliku JSON (CHARACTERS_FILE, domyślnie characters/default.json, który zawiera dwie przykładowe postacie):

{
  "characters": [
    {
      "id": "mira",
      "name": "Mira",
      "system": "You are Mira, ... Never speak or act for {{user}}.",
      "greeting": "Welcome aboard, {{user}}!",
      "model": "MODEL_ID_FROM_CATALOG"
    }
  ]
}

• system to instrukcje postaci. greeting (opcjonalne) to jej pierwsza kwestia. model (opcjonalne) przypina model czatu do tej postaci.
• {{char}} i {{user}} są zastępowane imieniem postaci i imieniem osoby.
• Wpisami mogą być też JSON-y Character Card V2, czyli format eksportowany przez większość serwisów z postaciami i przez SillyTavern. Używane są opis, osobowość, scenariusz, przykładowy dialog i pierwsza wiadomość.

W Dockerze zamontuj własny plik i wskaż go w ustawieniu. W docker-compose.yml:

volumes:
  - ./my-characters.json:/app/characters/custom.json:ro

A w .env:

CHARACTERS_FILE=characters/custom.json

Bot pamięta HISTORY_TURNS wymian na rozmowę (domyślnie 20) i ogranicza odpowiedzi do CHAT_MAX_TOKENS tokenów (domyślnie 2048). Modele z rozumowaniem wliczają swoje myślenie do tego limitu, więc bardzo mała wartość może nie zostawić miejsca na odpowiedź. Więcej o pisaniu postaci znajdziesz w Chat recipes.

Wysyłanie zdjęć jest domyślnie wyłączone

Domyślnie można animować tylko obrazy wygenerowane przez bota. Zamienianie zdjęć prawdziwych osób w wideo to główny sposób, w jaki nadużywa się takich botów, a osoba na zdjęciu nie zgodziła się pojawić w twoim wideo.

Jeśli ustawisz ALLOW_PHOTO_UPLOADS=true, każdy, komu pozwolisz, może animować zdjęcie, które wyśle. Włączaj to tylko dla osób, którym ufasz, i tylko dla zdjęć dorosłych, którzy się na to zgodzili. Gdy opcja jest włączona, przesłane obrazy są pobierane przez bota i przechowywane w SpicyAPI. Linki do plików Telegrama nigdy nie są przekazywane dalej, ponieważ zawierają token twojego bota.

Prywatność: co jest przechowywane i gdzie

Ustaw RETENTION_SECONDS, aby poprosić SpicyAPI o usunięcie wyników i promptów wcześniej niż wynosi domyślny okres twojego konta.

W grupach wyniki są ukryte za spoilerem (SPOILER_MEDIA, domyślnie groups; inne wartości to always i never). /report przekazuje wiadomość właścicielowi. Treści naruszające zasady SpicyAPI można też zgłaszać na spicyapi.ai/abuse.

Rozwiązywanie problemów

Kody błędów wyjaśnia strona Błędy.