Authentication

Create an API token (`sk-...`) and send it in the Authorization header when calling Starrise-api.

Terminology

API Token is your credential for /v1/*, /mj/*, /suno/*, etc. LLM tokens are units models use to measure text length for billing.

Create a Token

Register and log in to the console
Open Tokens
Click Create Token
Configure as needed:

Option	Description
Name	A label such as `production`
Expiration	Optional; leave blank for no expiry
Quota	Cap usage for this token
Unlimited quota	No per-token cap (account balance still applies)
Model restrictions	Allow only selected models
IP allowlist	Restrict caller IP addresses

Submit — copy the full key from the token list (Copy). The complete key is only shown once at creation.

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

You can batch-create multiple tokens in one submit.

Use in API Requests

curl https://api.starrise.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hi"}]}'

The API accepts:

Authorization: Bearer sk-... or Bearer <key> (prefix sk- is stripped)
Claude: x-api-key: sk-... on /v1/messages and /v1/models
Gemini: x-goog-api-key or query ?key=sk-...
Midjourney: mj-api-secret: sk-...
Realtime WebSocket: key in Sec-WebSocket-Protocol subprotocol

Store tokens in environment variables:

export STARRISE_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Manage Tokens

Action	Description
View	Name, status, quota usage, expiration
Edit	Update config (key hash cannot be changed)
Copy	Reveal full key once from list actions
Delete	Revoke immediately

Security Best Practices

Recommended

One token per app and environment
Set quota limits for non-production tokens
Enable model limits and IP allowlists when possible
Never commit tokens to Git or embed in frontend code
Rotate after team changes

Common Errors

Status	Cause	Solution
`401`	Invalid or missing token	Verify key and header
`403`	Model/IP restricted or account issue	Check token settings or contact support
`429`	Quota or rate limit exceeded	Top up or increase limits

FAQ

Can I view the full key after creation? Use Copy in the token list if still available; otherwise create a new token.

Does unlimited quota bypass account balance? No. Account balance and platform policies still apply.