Serenity Star account
A Serenity Star account gives you direct access to Serenity Edge: you create API keys, buy prepaid credits and see your usage, all from the same place. Serenity Star also handles authentication and billing for this traffic, in the EU: your requests pass through Serenity Star's API on their way to the models.
Set up
- Sign in to Serenity Star, or create an account.
- Open the API keys section and create a key for Serenity Edge. Copy it once; it is not shown again.
- Add prepaid credits. Usage is deducted from the balance at the prices of your Serenity Star account.
- Send your first request following Getting started, with
base_urlset tohttps://api.serenityedge.ai/v1.
Self-service key creation and credit top-up for Serenity Edge inside Serenity Star are being rolled out. Until they are available to every account, write to contact@substrate.ai to get a key and an initial credit balance.
Models
With a Serenity Star key, POST /v1/chat/completions and POST /v1/responses serve these models:
| Model | Also callable as |
|---|---|
orion-pro-26.2 | orion-pro |
orion-plus-26.1 | orion-plus |
qwen3.6-35b-a3b | qwen/qwen3.6-35b-a3b |
The other models, qwen3.8-27b and paddleocr-vl-1.6, answer HTTP 404 with code: "model_not_found" to a Serenity Star key. The decision, embeddings, rerank and redaction endpoints answer HTTP 403 with code: "permission_denied". They need a Serenity Edge API key, from an enterprise contract.
Credits and billing
-
Serenity Star bills your usage at the prices of your Serenity Star account. The prices in Pricing and limits are those of Serenity Edge API keys.
-
Credits are prepaid and non-transferable. Consumption is metered on the
usageobject of each response. -
A request that your account's plan or credit balance does not cover fails with HTTP 403,
type: "permission_error"andcode: "permission_denied", with the messageThis API key is not allowed to use this model or feature. Check your account, plan or credits.Retrying does not help: top up first. See Errors and rate limits. -
Invoices are issued by Serenity Star in the EU. Authentication and billing data are processed in Microsoft Azure data centres in the EU; see Data residency.
Keys
- Create one key per application or environment so you can rotate or revoke them independently.
- Keys carry the default rate limits of the account. Limits grow with usage; write to contact@substrate.ai if you need more sooner.
- Revoke a key immediately if it leaks. Requests with a revoked key return HTTP 401.