TheHive (image generation)

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 Statistics 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:
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 System Config → AI 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.

Related