Use your deployment for typed decisions
Your API key also works for stateless judgments without creating a chat. Configure your existing decision model on the API server. Calls requiresessions:create in the target workspace and honor its inference residency.
POST /v1/workspaces/{id}/decisions uses the deployment’s configured model,
not a caller-selected model or credential. It supports predicates, choices and
scores with typed refusals. The deployment pays its provider directly; calls
neither consume nor consult customer agent allowances. Use one platform
workspace and the optional tenant label for per-customer cost reporting.
Usage and provider-cost receipts are written after the response; unknown costs
remain unknown. Abrupt API-process loss before persistence can lose a queued
receipt; normal shutdown drains it and database failures retry without inference.
What you run
In production, use managed services or official charts for Postgres, Temporal, NATS, and object storage. The chart’s built-in copies are for local and smoke testing.
Install with Helm
Charts are published as OCI artifacts underghcr.io/cloudgeni-ai. Each release’s BOM lists the chart reference and image digests. Pin the chart to the version you run and keep secrets in a Kubernetes Secret:
Reference infrastructure
Terraform for Azure, AWS, and GCP lives underdeploy/terraform. List the deployment profiles and plan one:
Access modes
OPENGENI_PRODUCT_ACCESS_MODE sets how callers are identified:
Outside local development,
configured mode needs either OPENGENI_DELEGATION_SECRET (delegated tokens) or OPENGENI_AUTH_REQUIRED=true with OPENGENI_ACCESS_KEY (a shared key sent as x-opengeni-access-key). The shared key is a simple perimeter, not per-tenant access control. See the security boundary.
Credit coupons
With Stripe billing enabled, customers redeem promotion codes in the console. You create and manage the codes in your own Stripe account. Scoped offers redeem their fixed credit amount through a $0 checkout; customers buy additional credits separately. Plan checkout also takes a code, but only one whose Stripe coupon is restricted to that plan’s product; see subscription promotion codes. SetOPENGENI_WEB_BASE_URL if the console and API use different origins.
Signup and coupon credits can share an editable model list, with overrides per offer. The model picker shows which credits a model uses and marks models the remaining credits do not cover; billing shows the models each grant covers. Operators can update that coverage for existing promotional balances without restarting services. Follow the promotional credit setup for activation and the policy command.
Connected subscriptions over the API
By default, connected AI subscriptions (Claude, Codex, SuperGrok) serve only work in the Opengeni apps. API requests, including organization access keys and embedded products, that select one get403 with subscription_api_unavailable, and API model lists and defaults leave subscriptions out.
If you run your own deployment and own the subscriptions you connect, you can let API work use them: set OPENGENI_API_CONNECTED_SUBSCRIPTIONS_ENABLED=true on the API and worker processes (with Helm, under config). It applies to the whole deployment, and API callers cannot change it. Agent turns, goals, schedules, stateless model calls, transcription, realtime voice, titles, model lists and defaults then treat API work like app work. Paid-plan requirements still apply where credit billing is on.
You are responsible for complying with your model provider’s terms when you use a subscription
this way.
Before you expose it
Put the deployment behind a gateway with:- TLS
- Authentication for every user-facing route
- Rate and request-size limits sized for sessions, files, and SSE
- SSE support: buffering off, read and send timeouts of at least 3600 seconds
- Access logs
Console links
The console’s Help entry opens the public Opengeni docs. SetOPENGENI_DOCUMENTATION_URL to your own docs, or none to hide it.
For link previews in Slack and other chat tools, set OPENGENI_PUBLIC_BASE_URL to the public address, and OPENGENI_WEB_BASE_URL to the console origin if it differs from the API.