Bot Telegram et Discord

Le bot SpicyAPI est un petit programme que vous exécutez vous-même. Il se connecte à Telegram (et, si vous le souhaitez, à Discord) et permet aux personnes que vous autorisez de générer des images, de créer des vidéos, de transformer des images en vidéos et de discuter avec des personnages que vous définissez. Tout est payé sur votre propre solde SpicyAPI, et chaque requête est chiffrée avant tout débit.

Le bot est gratuit et open source (MIT) sur github.com/spicyapi-ai/spicyapi-bot. Il est privé par défaut : vous seul pouvez l’utiliser tant que vous n’autorisez pas d’autres personnes ou groupes.

Ce que fait le bot

• Images : /pic a lighthouse at dusk
• Vidéos : /vid waves rolling onto a beach at sunset
• Animate : appuyez sur Animate sous n’importe quelle image créée par le bot, ou répondez-y avec /animate <how it should move>.
• Chat avec un personnage : écrivez dans une conversation privée, ou utilisez /talk. Les réponses arrivent au fil de l’eau dans un seul message.
• Protection des dépenses : chaque requête est chiffrée d’abord (les devis sont gratuits), les plus coûteuses demandent un appui sur Confirm, et des limites quotidiennes par personne et pour l’ensemble du bot sont appliquées.
• Privé par défaut : personne d’autre ne peut l’utiliser tant que vous ne l’avez pas autorisé.

Le catalogue de SpicyAPI comprend des modèles sans censure qui n’ajoutent aucun filtre de contenu de leur part, et le bot fonctionne avec le modèle que vous choisissez. La loi et la politique de contenu de SpicyAPI s’appliquent toujours à tout ce que vous générez. Voir Politique.

Commandes

Les noms ne sont volontairement pas /image, /video ou /chat, que d’autres bots populaires utilisent : ce bot peut ainsi partager un groupe avec eux. Dans un groupe Telegram, répondez à l’un des messages de chat du bot pour continuer à parler au personnage.

Avant de commencer

• Un ordinateur ou un serveur qui reste allumé, avec Docker installé. (Ou un compte Railway, voir plus bas.)
• Un compte SpicyAPI avec un solde. Voir Préparer votre compte et Facturation.
• Un compte Telegram, pour créer le bot avec BotFather.

Déployer avec 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

Pour mettre à jour plus tard, lancez git pull && docker compose up -d --build.

Déployer sur Railway

Railway peut exécuter le bot sans serveur à vous. Il n’existe pas de modèle en un clic : vous déployez depuis votre propre copie du dépôt.

Gardez le service à un seul réplica : deux copies qui interrogent le même jeton Telegram se disputent les mises à jour. Le bot n’a besoin d’aucun domaine public ni d’aucun port ouvert.

Ajouter Discord (facultatif)

Discord n’autorise pas dans son App Directory les applications dotées de commandes réservées aux adultes : gardez donc le bot privé. .env.example contient aussi DISCORD_MEDIA_IN_DMS, qui vaut false par défaut : les images et les vidéos ne fonctionnent alors que dans les salons de serveur réservés aux adultes, pas dans les messages privés.

Qui peut l’utiliser

Les inconnus qui trouvent le bot apprennent qu’il est privé et reçoivent leur identifiant utilisateur à vous transmettre. Les groupes sont ignorés tant qu’ils ne figurent pas dans ALLOWED_CHAT_IDS ; dès qu’un groupe y figure, tous ses membres peuvent utiliser le bot, dans la limite des plafonds quotidiens. Les identifiants de groupe Telegram sont négatifs, par exemple -1001234567890.

Vous exploitez ce bot et vous êtes responsable des personnes que vous laissez l’utiliser. Les conditions de SpicyAPI s’appliquent, y compris les régions que SpicyAPI ne dessert pas.

Comment fonctionnent les dépenses

1. Le prix d’abord. Chaque image ou vidéo est chiffrée par SpicyAPI avant que quoi que ce soit ne se passe. Les devis sont gratuits.
2. Plafond strict. Si une requête pouvait coûter plus que MAX_COST_PER_REQUEST_USD (1 $ par défaut), elle est refusée. Rien n’est débité.
3. Confirmation. Si elle pouvait coûter plus que CONFIRM_ABOVE_USD (0,10 $ par défaut), le bot affiche le prix avec les boutons Confirm et Cancel. Seule la personne qui a fait la demande peut confirmer.
4. Limites quotidiennes. Chaque personne peut dépenser USER_DAILY_BUDGET_USD (1 $ par défaut) par jour UTC et l’ensemble du bot DAILY_BUDGET_USD (5 $ par défaut). Les générations en cours comptent comme dépensées jusqu’à leur fin : plusieurs requêtes simultanées ne peuvent donc pas contourner une limite. Les propriétaires ne sont soumis qu’à la limite de l’ensemble du bot.
5. Pas de double débit. Chaque requête porte une clé d’idempotence dérivée du message de chat ou de l’appui sur le bouton : une mise à jour Telegram dupliquée ou un double appui renvoie la tâche qui existe déjà.
6. Résultats. La progression est affichée en modifiant un message toutes les quelques secondes. Le résultat indique le débit réel et l’identifiant de la tâche, que vous pouvez retrouver sous Logs dans la console.

Une génération acceptée ne peut pas être annulée. Les exécutions réussies sont facturées ; les échecs ordinaires libèrent la réservation. Certains refus de contenu ne sont facturés que si la page du modèle l’indique explicitement. Voir Facturation.

Utiliser une clé plafonnée

Le bot tient son propre registre dans DATA_DIR/state.json. Si ce fichier est perdu, le bot oublie ce qui a été dépensé aujourd’hui. Le plafond de la clé API dans la console est la limite qui ne peut jamais être perdue, car SpicyAPI l’applique. Créez une clé distincte pour le bot, définissez un plafond de dépense quotidien et, si vous le souhaitez, n’autorisez que les modèles voulus. Lorsque le plafond est atteint, le bot vous indique que la clé a atteint son plafond de dépense.

Autres réglages utiles :

Modèles et prix

Chaque personne peut changer ses modèles avec /models. L’opérateur définit les valeurs par défaut :

Les identifiants exacts des modèles figurent dans .env.example ; pour en changer, copiez un autre identifiant depuis le catalogue en ligne (GET /api/v1/models ; dans l’exemple de personnage ci-dessous, MODEL_ID_FROM_CATALOG marque l’endroit où un tel identifiant va). Les prix proviennent du catalogue public et peuvent changer ; le bot affiche toujours le devis en direct. Parcourez les modèles sur spicyapi.ai/models ou voir Modèles. Pour le jeu de rôle, le classement jeu de rôle aide à choisir un modèle de chat.

Personnages

Les personnages vivent dans un fichier JSON (CHARACTERS_FILE, par défaut characters/default.json, qui contient deux personnages d’exemple) :

{
  "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 correspond aux instructions du personnage. greeting (facultatif) est sa première réplique. model (facultatif) fixe un modèle de chat pour ce personnage.
• {{char}} et {{user}} sont remplacés par le nom du personnage et le prénom de la personne.
• Les entrées peuvent aussi être du JSON Character Card V2, le format que la plupart des sites de personnages et SillyTavern exportent. La description, la personnalité, le scénario, l’exemple de dialogue et le premier message sont utilisés.

Avec Docker, montez votre propre fichier et pointez le réglage dessus. Dans docker-compose.yml :

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

Et dans .env :

CHARACTERS_FILE=characters/custom.json

Le bot retient HISTORY_TURNS échanges par conversation (20 par défaut) et limite les réponses à CHAT_MAX_TOKENS tokens (2048 par défaut). Les modèles de raisonnement comptent leur réflexion dans cette limite : une valeur très petite peut ne laisser aucune place à la réponse. Voir Recettes de chat pour en savoir plus sur la rédaction de personnages.

L’envoi de photos est désactivé par défaut

Par défaut, seules les images générées par le bot peuvent être animées. Transformer des photos de personnes réelles en vidéos est la principale manière dont des bots de ce genre sont détournés, et une personne figurant sur une photo n’a pas accepté d’apparaître dans votre vidéo.

Si vous définissez ALLOW_PHOTO_UPLOADS=true, toute personne que vous autorisez peut animer une photo qu’elle envoie. N’activez cela que pour des personnes de confiance, et uniquement pour des photos d’adultes consentants. Lorsque l’option est activée, les images envoyées sont téléchargées par le bot et stockées chez SpicyAPI. Les liens de fichiers Telegram ne sont jamais transmis, car ils contiennent le jeton de votre bot.

Confidentialité : ce qui est stocké où

Définissez RETENTION_SECONDS pour demander à SpicyAPI de supprimer les résultats et les prompts plus tôt que la valeur par défaut de votre compte.

Dans les groupes, les résultats sont masqués derrière un spoiler (SPOILER_MEDIA, par défaut groups ; les autres valeurs sont always et never). /report transmet un message au propriétaire. Un contenu qui enfreint les règles de SpicyAPI peut aussi être signalé sur spicyapi.ai/abuse.

Dépannage

Les codes d’erreur sont expliqués dans Erreurs.