Telegram- und Discord-Bot

Der SpicyAPI-Bot ist ein kleines Programm, das Sie selbst betreiben. Er verbindet sich mit Telegram (und auf Wunsch mit Discord) und lässt die Personen, die Sie zulassen, Bilder erzeugen, Videos erstellen, Bilder in Videos verwandeln und mit Figuren chatten, die Sie definieren. Alles wird aus Ihrem eigenen SpicyAPI-Guthaben bezahlt, und jede Anfrage wird bepreist, bevor etwas abgebucht wird.

Der Bot ist kostenlos und quelloffen (MIT) unter github.com/spicyapi-ai/spicyapi-bot. Er ist standardmäßig privat: Nur Sie können ihn nutzen, bis Sie weitere Personen oder Gruppen zulassen.

Was der Bot kann

• Bilder: /pic a lighthouse at dusk
• Videos: /vid waves rolling onto a beach at sunset
• Animate: Tippen Sie unter einem beliebigen vom Bot erzeugten Bild auf Animate oder antworten Sie darauf mit /animate <wie es sich bewegen soll>.
• Figuren-Chat: Schreiben Sie in einem privaten Chat einfach los oder nutzen Sie /talk. Die Antworten werden in eine einzige Nachricht gestreamt.
• Ausgabenschutz: Jede Anfrage wird zuerst bepreist (Angebote sind kostenlos), teure brauchen einen Tipp auf Confirm, und Tageslimits pro Person und für den ganzen Bot werden durchgesetzt.
• Standardmäßig privat: Niemand sonst kann ihn nutzen, bis Sie ihn freigeben.

Der Katalog von SpicyAPI enthält unzensierte Modelle, die keinen eigenen Inhaltsfilter hinzufügen, und der Bot funktioniert mit jedem Modell, das Sie wählen. Das Gesetz und die Inhaltsrichtlinie von SpicyAPI gelten weiterhin für alles, was Sie erzeugen. Siehe Richtlinie.

Befehle

Die Namen lauten bewusst nicht /image, /video oder /chat, wie sie andere beliebte Bots verwenden, damit dieser Bot sich eine Gruppe mit ihnen teilen kann. Antworten Sie in einer Telegram-Gruppe auf eine Chat-Nachricht des Bots, um weiter mit der Figur zu sprechen.

Bevor Sie anfangen

• Einen Computer oder Server, der durchgehend läuft, mit installiertem Docker. (Oder ein Railway-Konto, siehe unten.)
• Ein SpicyAPI-Konto mit Guthaben. Siehe Konto einrichten und Abrechnung.
• Ein Telegram-Konto, um den Bot mit BotFather zu erstellen.

Mit Docker Compose bereitstellen

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

Zum späteren Aktualisieren führen Sie git pull && docker compose up -d --build aus.

Auf Railway bereitstellen

Railway kann den Bot ohne eigenen Server betreiben. Es gibt keine Ein-Klick-Vorlage: Sie stellen aus Ihrer eigenen Kopie des Repositorys bereit.

Lassen Sie den Dienst bei einem Replikat: Zwei Kopien, die dasselbe Telegram-Token abfragen, kämpfen um die Updates. Der Bot braucht keine öffentliche Domain und keinen offenen Port.

Discord hinzufügen (optional)

Discord erlaubt keine Apps mit altersbeschränkten Befehlen im App Directory, halten Sie den Bot daher privat. .env.example enthält außerdem DISCORD_MEDIA_IN_DMS, standardmäßig false: Bilder und Videos funktionieren dann nur in altersbeschränkten Serverkanälen, nicht in Direktnachrichten.

Wer ihn nutzen kann

Fremden, die den Bot finden, wird gesagt, dass er privat ist, und sie erhalten ihre Benutzer-ID, die sie Ihnen schicken können. Gruppen werden ignoriert, bis sie in ALLOWED_CHAT_IDS stehen; sobald eine Gruppe eingetragen ist, kann jedes Mitglied den Bot im Rahmen der Tageslimits nutzen. Telegram-Gruppen-IDs sind negativ, zum Beispiel -1001234567890.

Sie betreiben diesen Bot und sind dafür verantwortlich, wen Sie ihn nutzen lassen. Es gelten die Nutzungsbedingungen von SpicyAPI, einschließlich der Regionen, die SpicyAPI nicht bedient.

Wie die Ausgaben funktionieren

1. Erst der Preis. Jedes Bild und jedes Video wird von SpicyAPI bepreist, bevor etwas passiert. Angebote sind kostenlos.
2. Harte Obergrenze. Könnte eine Anfrage mehr als MAX_COST_PER_REQUEST_USD (Standard $1) kosten, wird sie abgelehnt. Es wird nichts abgebucht.
3. Bestätigung. Könnte sie mehr als CONFIRM_ABOVE_USD (Standard $0.10) kosten, zeigt der Bot den Preis mit den Buttons Confirm und Cancel. Nur die Person, die gefragt hat, kann bestätigen.
4. Tageslimits. Jede Person darf pro UTC-Tag USER_DAILY_BUDGET_USD (Standard $1) ausgeben und der ganze Bot DAILY_BUDGET_USD (Standard $5). Noch laufende Generierungen zählen bis zu ihrem Ende als ausgegeben, sodass mehrere gleichzeitige Anfragen kein Limit umgehen können. Besitzer sind nur an das Limit für den ganzen Bot gebunden.
5. Keine doppelten Abbuchungen. Jede Anfrage trägt einen Idempotency-Key, der aus der Chat-Nachricht oder dem Button-Tipp abgeleitet wird, sodass ein doppeltes Telegram-Update oder ein doppeltes Tippen die bereits bestehende Aufgabe zurückgibt.
6. Ergebnisse. Der Fortschritt wird durch das Bearbeiten einer Nachricht alle paar Sekunden angezeigt. Das Ergebnis zeigt die tatsächliche Abbuchung und die Task-ID, die Sie unter Logs in der Konsole nachschlagen können.

Eine angenommene Generierung kann nicht abgebrochen werden. Erfolgreiche Läufe werden berechnet; gewöhnliche Fehlschläge geben die Reservierung frei. Bestimmte Inhaltsablehnungen werden nur berechnet, wenn die Modellseite dies ausdrücklich angibt. Siehe Abrechnung.

Einen Schlüssel mit Limit verwenden

Der Bot führt sein eigenes Hauptbuch in DATA_DIR/state.json. Geht diese Datei verloren, vergisst der Bot, was heute ausgegeben wurde. Das Limit auf dem API-Schlüssel in der Konsole ist das Limit, das nie verloren gehen kann, weil SpicyAPI es durchsetzt. Erstellen Sie einen eigenen Schlüssel für den Bot, setzen Sie ein Tageslimit und erlauben Sie optional nur die gewünschten Modelle. Ist das Limit erreicht, teilt der Bot mit, dass der Schlüssel sein Ausgabenlimit erreicht hat.

Weitere nützliche Einstellungen:

Modelle und Preise

Jede Person kann ihre Modelle mit /models ändern. Die Standardwerte legt der Betreiber fest:

Die genauen Modell-IDs stehen in .env.example; zum Wechseln kopieren Sie eine andere ID aus dem Live-Katalog (GET /api/v1/models; im Figurenbeispiel unten markiert MODEL_ID_FROM_CATALOG die Stelle, an die eine solche ID gehört). Die Preise stammen aus dem öffentlichen Katalog und können sich ändern; der Bot zeigt immer das aktuelle Angebot. Modelle durchsuchen Sie unter spicyapi.ai/models, oder siehe Modelle. Für Rollenspiele hilft das Roleplay-Leaderboard bei der Wahl eines Chatmodells.

Figuren

Figuren liegen in einer JSON-Datei (CHARACTERS_FILE, Standard characters/default.json, die zwei Beispielfiguren enthält):

{
  "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 sind die Anweisungen der Figur. greeting (optional) ist ihre erste Zeile. model (optional) legt für diese Figur ein Chatmodell fest.
• {{char}} und {{user}} werden durch den Namen der Figur und den Vornamen der Person ersetzt.
• Einträge können auch Character-Card-V2-JSON sein, das Format, das die meisten Figuren-Seiten und SillyTavern exportieren. Beschreibung, Persönlichkeit, Szenario, Beispieldialog und erste Nachricht werden verwendet.

Mit Docker binden Sie Ihre eigene Datei ein und richten die Einstellung darauf. In docker-compose.yml:

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

Und in .env:

CHARACTERS_FILE=characters/custom.json

Der Bot merkt sich HISTORY_TURNS Wortwechsel pro Unterhaltung (Standard 20) und begrenzt Antworten auf CHAT_MAX_TOKENS Tokens (Standard 2048). Reasoning-Modelle rechnen ihr Nachdenken auf dieses Limit an, ein sehr kleiner Wert kann also keinen Platz für die Antwort lassen. Mehr zum Schreiben von Figuren finden Sie unter Chat-Rezepte.

Foto-Uploads sind standardmäßig aus

Standardmäßig lassen sich nur vom Bot erzeugte Bilder animieren. Fotos echter Personen in Videos zu verwandeln, ist der häufigste Weg, wie Bots dieser Art missbraucht werden, und eine Person auf einem Foto hat nicht zugestimmt, in Ihrem Video aufzutauchen.

Wenn Sie ALLOW_PHOTO_UPLOADS=true setzen, kann jede von Ihnen zugelassene Person ein gesendetes Foto animieren. Schalten Sie das nur für Personen ein, denen Sie vertrauen, und nur für Fotos von Erwachsenen, die zugestimmt haben. Ist es eingeschaltet, werden hochgeladene Bilder vom Bot heruntergeladen und bei SpicyAPI gespeichert. Telegram-Dateilinks werden nie weitergegeben, weil sie Ihr Bot-Token enthalten.

Datenschutz: was wo gespeichert wird

Setzen Sie RETENTION_SECONDS, um SpicyAPI zu bitten, Ergebnisse und Prompts früher zu löschen als die Standarddauer Ihres Kontos.

In Gruppen werden Ergebnisse hinter einem Spoiler versteckt (SPOILER_MEDIA, Standard groups; weitere Werte sind always und never). /report leitet eine Nachricht an den Besitzer weiter. Inhalte, die gegen die Regeln von SpicyAPI verstoßen, können Sie außerdem unter spicyapi.ai/abuse melden.

Fehlerbehebung

Die Fehlercodes sind unter Fehler erklärt.