Reference

Data classes

The kind of data decides the alias, and the key decides which aliases you can reach. A key cleared for children’s data cannot name anything else.

Early accessBy invitationLast updated

Three classes

Each key is cleared for one class
ClassExamplesAliases
PublicNews, public web pages, market data, generated images, public marketing copyThe personal set, plus askshiva-flash-public and, case by case, askshiva-reason
PersonalEnd-user chat, business records, birth details, HR records, startup ideas, screenshotsaskshiva-flash-pd, askshiva-reason-pd, askshiva-strict, askshiva-embed-oai, plus any general aliases on your key (see below)
ChildrenAnything from a children’s or school productaskshiva-kids, askshiva-kids-fast, askshiva-embed-oai and nothing else

If you are unsure, treat data as personal. If any user could be a child, treat it as children’s data.

Enforced by key, not by goodwill

  • Each key’s model list holds only the aliases cleared for its class. Asking for anything else returns HTTP 403.
  • GET /models shows exactly that list. A children’s key sees three names.
  • Children’s aliases have no fallback of any kind, so a failure returns an error rather than reaching another provider.
  • Personal and public data-class aliases have a short, fixed chain that ends in a final step with no further fallback. A fallback never crosses a class.

Test what you send

Routing rules limit where a request can go. They cannot see what is inside it. Your app is responsible for sending each request with the key of the right class.

Where each class may go

Data-class aliases and their fallbacks
AliasClassFallback
askshiva-flash-pdPersonalUp to two steps, ending in a fixed final step. No China-hosted endpoint.
askshiva-reason-pdPersonalOne step, to a fixed final step. No China-hosted endpoint.
askshiva-strictPersonalOne step, to a fixed final step.
askshiva-flash-publicPublicOne step, to a fixed final step. Public data only.
askshiva-kidsChildrenNone. One approved provider only.
askshiva-kids-fastChildrenNone. One approved provider only.
askshiva-embed-oaiAnyNone. One provider only, so vectors stay in one space.

General aliases and personal data

Whether a general alias such as askshiva-fast may carry personal data depends on the terms of the provider behind it, and we review each provider before clearing it. Until a review is finished, use the -pd aliases for personal data. Some keys also list general aliases that an app used before the data-class aliases existed; for new personal-data work, use the -pd aliases.

Where it runs

  • The gateway runs on rented servers in the USA. It does not run in India today.
  • The spend ledger is configured not to store prompts or responses; it records the key, model, token counts and cost.
  • Our own children’s products run with demo data only on these servers.
  • Before any real personal data goes through, check each provider’s terms and hosting against your own obligations. This page describes routing rules and is not legal advice.