Run our services from your own software
Our services run inside your product: the same form fields, the same price and the same credits as on the site. A key takes a minute to issue in your account.
How it works
Four steps from key to result — and two things worth knowing up front.
1. Issue a key
In your account, the “API keys” tab. A live key starts with sk_live_ and spends your account's credits; a test key starts with sk_test_ and spends nothing. The key is shown once — we keep only a fingerprint.
2. Pick a service
GET /api/v1/services returns the catalogue: the slug, what comes back, the price in credits and the form fields with their option lists. Exactly the fields a person sees on the service page.
3. Run it
POST /api/v1/generate with {"service":"remove-background","input":{"photo":"https://…"}}. The response is a job: id, status, price and a link to the result. Quick work returns at once; long work arrives by webhook.
Sandbox
Add "dry_run": true and any key will price the run, validate the fields and answer in the same shape without charging. A test key does this always and also fires the webhook, so you can debug delivery before spending anything.
Webhooks
Set the address on the key; the callback arrives with X-Generonium-Timestamp and X-Generonium-Signature. The signature is HMAC-SHA256 over “timestamp.body” with your secret — always verify it, otherwise anyone can post you a “done”.
Price and credits
A run costs what it costs on the site and comes off the same balance. A failed run refunds the credits. The daily cap per key is visible in your account — it protects you from your own runaway loop.
What the API returns — and what it does not
The API returns the work: a finished frame, clip, sound or text. It does not return how that result was made — no prompt, no model name, no provider — and it does not pass arbitrary text to a model: a run is made of the service's own form fields. This is deliberate: the recipe is the work, and raw access to third-party models you can buy cheaper without us.
Endpoints
- CatalogueGET /api/v1/servicesThe catalogue, 100 per page: slug, price, fields.
- CatalogueGET /api/v1/services/{service}One service: fields, options, required flags, price.
- WorkPOST /api/v1/generateRun it. Body: service, input, optional dry_run.
- WorkGET /api/v1/jobs/{id}Job status and result, in case the webhook did not arrive.
- OpenAPIGET /api/v1/openapi.jsonThe machine-readable spec — for your client generator.
Questions
Generonium pricingCredits work across every service
Лайт
30-day subscription
- Granted on payment and every 30 days
- Auto-renewal can be turned off in your account
- Credits work with any Generonium service
- Each service shows its exact price before launch
Про
30-day subscription
- Granted on payment and every 30 days
- Auto-renewal can be turned off in your account
- Credits work with any Generonium service
- Each service shows its exact price before launch
Макс
30-day subscription
- Granted on payment and every 30 days
- Auto-renewal can be turned off in your account
- Credits work with any Generonium service
- Each service shows its exact price before launch
Start in the sandbox
A test key is free and behaves like a live one — you can build the whole integration without spending a credit.