canonical: https://jentic.com/apis/fungenerators.com/fungenerators-taunt # Fungenerators Taunt as a service The Taunt as a service API generates random taunts and insults across many themed categories. Two endpoints cover listing the supported categories and generating a taunt within a chosen category. The API powers playful roast features in chatbots, wrong-answer feedback in puzzle apps, and themed comedic content in social tools and games. Responses are short JSON strings ready to render in any UI without further processing. ## For AI agents Generate themed random taunts and insults from many categories, with a separate endpoint to list the available categories. ## Scope Does not moderate or filter content for safety, generate audio, or score user responses - use for retrieving themed taunts and category lists only. ## Capabilities - Generate a random taunt within a chosen themed category - List all supported taunt categories for selection menus - Produce comedic wrong-answer feedback for puzzle and quiz apps - Supply playful roast lines for chatbots and Discord bots - Populate themed game NPCs with signature taunts ## Use cases ### Wrong-Answer Feedback in Quiz Apps Quiz and puzzle apps use a themed taunt as the response when a user answers incorrectly. Selecting a category that matches the quiz topic keeps the comedy on-brand. The integration is two calls: list categories once, then generate a taunt on each wrong answer. Example prompt: On a wrong quiz answer, call GET `/taunt/generate` with category=sports and display the returned taunt to the user. ### Chatbot Roast Mode Chatbots and Discord bots add a 'roast me' command that calls the taunt endpoint and replies with a playful insult. Bot operators choose categories that match their server's tone, from gentle ribbing to harder-edged humour. Example prompt: On the 'roast me' intent, call GET `/taunt/generate` with category=general and reply with the taunt. ### Game NPCs with Signature Taunts Game studios attach a taunt to each NPC profile to give them voice. The API supplies on-demand themed lines, so studios do not have to maintain a custom taunt corpus. NPCs can also speak a fresh line each encounter rather than the same scripted insult. Example prompt: When the player engages an NPC, call GET `/taunt/generate` with the NPC's category to produce its line. ### AI Agent Roast Tool Wire the Taunt API into Jentic so any agent can produce a themed taunt on request. Through Jentic the agent searches by intent, the API key remains vaulted, and the agent receives the taunt JSON to use in its reply or in a downstream content workflow. Example prompt: Use Jentic to search 'generate a themed taunt', load GET `/taunt/generate`, and execute it with the user's chosen category. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/taunt/generate` | Generate a random taunt in a chosen category | | GET | `/taunt/categories` | List supported taunt categories | ## Key resources - **Taunt Generation** — Generate a random taunt in a chosen category - **Categories** — List the supported taunt categories ## Why Jentic - **Setup:** Wiring the Fungenerators Taunt as a service API by hand means sending an secret-key request header on every call to api.fungenerators.com and reading the categories route to know which themes are valid. Through Jentic you install once, import Taunt as a service from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The Taunt API takes its input in query parameters rather than a resource path, so you limit the agent to the operations it needs, such as generating a themed taunt or listing categories. You choose which operations it may call, and nothing outside that set runs. - **Credential handling:** Your Fungenerators API key is stored once, encrypted, by your own Jentic One instance and injected into the secret-key request header at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'generate a themed taunt' or 'list taunt categories', and Jentic returns the matching GET `/taunt/generate` or GET `/taunt/categories` operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Pirates API** — Same vendor; pirate-themed insults as a focused alternative to general taunts - **Shakespeare API** — Same vendor; Shakespearean insults for period-themed apps - **Random Riddles API** — Same vendor; pairs riddles with taunts for mixed-content puzzle apps ## FAQ ### What authentication does the Taunt as a service API use? It uses an API key supplied in the X-Fungenerators-API-Secret request header. Through Jentic the key is stored encrypted and attached at execution time, never in the agent's prompt. ### Can I generate a category-specific taunt with this API? Yes. Call GET `/taunt/categories` to list the supported categories, then GET `/taunt/generate` with your chosen category to receive a taunt in that style. ### What are the rate limits for the Taunt API? The OpenAPI spec does not declare explicit rate limits. Fungenerators applies plan-based quotas published on the subscription page at fungenerators.com, so consult the plan you signed up for. ### How do I generate a taunt through Jentic? Search 'generate a themed taunt' via the Jentic SDK or MCP server, load GET `/taunt/generate`, and execute it with the desired category. Install with pip install jentic and authenticate using your ak_* key. ### Can I generate taunts in bulk? The generate endpoint returns a single taunt per call. To get a batch, loop GET `/taunt/generate` N times in your client and de-duplicate as results arrive. ### Are taunt categories user-configurable? No. Categories are fixed by Fungenerators and only modifiable by them. Call GET `/taunt/categories` at any time to see the current set. ### Can I limit what my agent is allowed to do with the Taunt as a service API? Yes. Because you run Jentic One yourself, your own rules decide which of this API's operations the agent may call, so you can allow only GET `/taunt/generate` for producing a themed taunt, only GET `/taunt/categories` for listing the supported categories, or both. This API passes its input through query parameters rather than a resource path, so scoping the agent to just the operations it needs is enough to keep anything outside that set from running. You also hold the Fungenerators API key in your own instance and attach it only when a permitted operation executes, so the agent never sees the credential directly.