Bot per Telegram e Discord

Il bot SpicyAPI è un piccolo programma che esegui tu stesso. Si collega a Telegram (e, se vuoi, a Discord) e permette alle persone che autorizzi di generare immagini, creare video, trasformare immagini in video e chattare con personaggi che definisci tu. Tutto viene pagato dal tuo saldo SpicyAPI, e ogni richiesta viene quotata prima che venga addebitato qualcosa.

Il bot è gratuito e open source (MIT) su github.com/spicyapi-ai/spicyapi-bot. È privato per impostazione predefinita: lo puoi usare solo tu, finché non autorizzi altre persone o gruppi.

Cosa fa il bot

• Immagini: /pic a lighthouse at dusk
• Video: /vid waves rolling onto a beach at sunset
• Animate: tocca Animate sotto qualsiasi immagine creata dal bot, oppure rispondile con /animate <come deve muoversi>.
• Chat con i personaggi: scrivi in una chat privata, oppure usa /talk. Le risposte arrivano in streaming in un unico messaggio.
• Protezione della spesa: ogni richiesta viene quotata prima (i preventivi sono gratuiti), quelle costose richiedono un tocco su Confirm, e vengono applicati limiti giornalieri per persona e per l’intero bot.
• Privato per impostazione predefinita: nessun altro può usarlo finché non lo autorizzi.

Il catalogo di SpicyAPI include modelli senza censura che non aggiungono filtri di contenuto propri, e il bot funziona con qualsiasi modello scegli. La legge e la policy sui contenuti di SpicyAPI valgono comunque per tutto ciò che generi. Vedi Policy.

Comandi

I nomi non sono volutamente /image, /video o /chat, usati da altri bot molto diffusi, così questo bot può convivere con loro in un gruppo. In un gruppo Telegram, rispondi a uno dei messaggi di chat del bot per continuare a parlare con il personaggio.

Prima di cominciare

• Un computer o un server sempre acceso, con Docker installato. (Oppure un account Railway, vedi sotto.)
• Un account SpicyAPI con un saldo. Vedi Configura il tuo account e Fatturazione.
• Un account Telegram, per creare il bot con BotFather.

Distribuzione con 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

Per aggiornare in seguito, esegui git pull && docker compose up -d --build.

Distribuzione su Railway

Railway può eseguire il bot senza un server tuo. Non c’è un template con un clic: lo distribuisci dalla tua copia del repository.

Tieni il servizio a una sola replica: due copie che interrogano lo stesso token Telegram si contendono gli aggiornamenti. Il bot non ha bisogno di un dominio pubblico né di una porta aperta.

Aggiungi Discord (facoltativo)

Discord non consente nella sua App Directory le app con comandi con limite di età, quindi mantieni il bot privato. .env.example contiene anche DISCORD_MEDIA_IN_DMS, che per impostazione predefinita è false: immagini e video allora funzionano solo nei canali del server con limite di età, non nei messaggi diretti.

Chi può usarlo

Agli sconosciuti che trovano il bot viene detto che è privato e viene dato il loro ID utente da inviarti. I gruppi vengono ignorati finché non sono elencati in ALLOWED_CHAT_IDS; una volta elencato un gruppo, ogni membro può usare il bot, entro i limiti giornalieri. Gli ID dei gruppi Telegram sono negativi, per esempio -1001234567890.

Il bot lo gestisci tu e sei responsabile di chi lo usa. Si applicano i termini di SpicyAPI, comprese le regioni che SpicyAPI non serve.

Come funziona la spesa

1. Prima il prezzo. Ogni immagine o video viene quotato da SpicyAPI prima che accada qualsiasi cosa. I preventivi sono gratuiti.
2. Tetto massimo. Se una richiesta potrebbe costare più di MAX_COST_PER_REQUEST_USD (predefinito $1), viene rifiutata. Non viene addebitato nulla.
3. Conferma. Se potrebbe costare più di CONFIRM_ABOVE_USD (predefinito $0,10), il bot mostra il prezzo con i pulsanti Confirm e Cancel. Solo chi ha fatto la richiesta può confermare.
4. Limiti giornalieri. Ogni persona può spendere USER_DAILY_BUDGET_USD (predefinito $1) per giorno UTC e l’intero bot DAILY_BUDGET_USD (predefinito $5). Le generazioni ancora in corso contano come spese finché non terminano, quindi più richieste simultanee non possono eludere un limite. I proprietari sono soggetti solo al limite dell’intero bot.
5. Nessun doppio addebito. Ogni richiesta porta una chiave di idempotenza derivata dal messaggio di chat o dal tocco sul pulsante, quindi un aggiornamento Telegram duplicato o un doppio tocco restituiscono l’attività già esistente.
6. Risultati. L’avanzamento viene mostrato modificando un solo messaggio ogni pochi secondi. Il risultato mostra l’addebito effettivo e l’ID dell’attività, che puoi cercare sotto Logs nella console.

Una generazione accettata non può essere annullata. Le esecuzioni riuscite vengono addebitate; i normali errori liberano l’importo riservato. Alcuni rifiuti di contenuto vengono addebitati solo quando la pagina del modello lo indica esplicitamente. Vedi Fatturazione.

Usa una chiave con tetto

Il bot tiene un proprio registro in DATA_DIR/state.json. Se quel file va perso, il bot dimentica quanto è stato speso oggi. Il tetto sulla chiave API nella console è il limite che non si può mai perdere, perché lo applica SpicyAPI. Crea una chiave separata per il bot, imposta un tetto di spesa giornaliero e, se vuoi, consenti solo i modelli che desideri. Quando il tetto viene raggiunto, il bot ti avvisa che la chiave ha raggiunto il suo tetto di spesa.

Altre impostazioni utili:

Modelli e prezzi

Ogni persona può cambiare i propri modelli con /models. L’operatore imposta i valori predefiniti:

Gli ID esatti dei modelli sono in .env.example; per cambiare, copia un altro ID dal catalogo in tempo reale (GET /api/v1/models; nell’esempio del personaggio qui sotto, MODEL_ID_FROM_CATALOG segna dove va un ID del genere). I prezzi provengono dal catalogo pubblico e possono cambiare; il bot mostra sempre il preventivo aggiornato. Sfoglia i modelli su spicyapi.ai/models oppure vedi Catalogo dei modelli. Per il roleplay, la classifica roleplay ti aiuta a scegliere un modello di chat.

Personaggi

I personaggi stanno in un file JSON (CHARACTERS_FILE, predefinito characters/default.json, che contiene due personaggi di esempio):

{
  "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 contiene le istruzioni del personaggio. greeting (facoltativo) è la sua prima battuta. model (facoltativo) assegna al personaggio un modello di chat fisso.
• {{char}} e {{user}} vengono sostituiti con il nome del personaggio e il nome di battesimo della persona.
• Le voci possono anche essere JSON Character Card V2, il formato esportato dalla maggior parte dei siti di personaggi e da SillyTavern. Vengono usati descrizione, personalità, scenario, dialoghi di esempio e primo messaggio.

Con Docker, monta il tuo file e punta l’impostazione verso di esso. In docker-compose.yml:

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

E in .env:

CHARACTERS_FILE=characters/custom.json

Il bot ricorda HISTORY_TURNS scambi per conversazione (predefinito 20) e limita le risposte a CHAT_MAX_TOKENS token (predefinito 2048). I modelli con ragionamento contano il loro pensiero in questo limite, quindi un valore molto piccolo può non lasciare spazio alla risposta. Per saperne di più su come scrivere i personaggi, vedi Ricette di chat.

Il caricamento di foto è disattivato per impostazione predefinita

Per impostazione predefinita si possono animare solo le immagini generate dal bot. Trasformare in video le foto di persone reali è il modo principale in cui bot come questo vengono usati in modo abusivo, e una persona in una foto non ha acconsentito a comparire nel tuo video.

Se imposti ALLOW_PHOTO_UPLOADS=true, chiunque tu autorizzi può animare una foto che invia. Attivalo solo per persone di cui ti fidi, e solo per foto di adulti consenzienti. Quando è attivo, le immagini caricate vengono scaricate dal bot e conservate presso SpicyAPI. I link ai file di Telegram non vengono mai passati oltre, perché contengono il token del tuo bot.

Privacy: cosa viene conservato e dove

Imposta RETENTION_SECONDS per chiedere a SpicyAPI di eliminare risultati e prompt prima del valore predefinito del tuo account.

Nei gruppi i risultati sono nascosti dietro uno spoiler (SPOILER_MEDIA, predefinito groups; gli altri valori sono always e never). /report inoltra un messaggio al proprietario. I contenuti che violano le regole di SpicyAPI si possono segnalare anche su spicyapi.ai/abuse.

Risoluzione dei problemi

I codici di errore sono spiegati in Errori.