SYNAPLAN // DOCS
Launch app

09 / Feature modules

TheHive (image generation)

On this page 7

Module id: thehive · Kind: provider · Configured by: THEHIVE_API_KEY · Provider: thehive

TheHive hosts fast open-weight image models behind a simple API. In Synaplan it adds four text-to-image models — Flux Schnell, Flux Schnell Enhanced, SDXL and SDXL Enhanced — as a cheap, quick alternative to the image models of the large providers. One environment variable switches it on.

What it adds#

  • Four text2pic rows in the model catalog, selectable in chat and usable by the multi-task planner for image steps.
  • Per-image pricing from the catalog, so the cost badge and the Usage page show what each generation cost.

Without it#

The TheHive rows are hidden; image generation uses whichever other provider you configured (OpenAI, Google Imagen, Higgsfield, xAI, …). Nothing else depends on it.

How to enable#

  1. Create an API key in the TheHive dashboard.
  2. Add it to the backend environment and restart backend + worker:
shell
THEHIVE_API_KEY=…
  1. Under Operate → System configuration → AI Models, make sure the TheHive rows are active and selectable; make one the default for image generation if you want the planner to prefer it.

TheHive is configured through the environment only — there is no key field for it on the Models & keys tab.

Check it works#

  • Operate → Feature Status → TheHive image generation shows Available / TheHive API key present. There is no network probe; the first generation is the live test. THEHIVE_API_KEY is unset means the module is off.
  • In chat, select Flux Schnell and ask for an image. A task card shows the generation and the finished picture appears in the answer.

Configuration reference#

Variable Default Meaning
THEHIVE_API_KEY empty API key. Empty = module off.

Model activation, defaults and prices live under Manage → Assistants → Models and are not part of the module.

Troubleshooting#

  • Key set, Feature Status still "Not installed". The backend and worker read the variable at start — restart both containers.
  • Generation fails with an authorization error. The key is wrong or the TheHive account has no credit. Check the dashboard.
  • Model not offered in chat. The row is switched off in the catalog, or the user's tier has no image generations left this period.
↑↓ navigate↵ openEsc close