# Shvydko

> Typed decisions over your context: Choice, Score and Noul. Operated by Codebridge Technology, Inc.

## API and integration

- [OpenAPI 3.1 contract](https://shvydko.ai/openapi.json): Public bearer-key endpoints only; no SDK installation required.

- [Full documentation](https://shvydko.ai/en/llms-full.txt): All current documentation as Markdown.

- [Runtime configuration](https://shvydko.ai/api/config): Current mode, published price and request limits. Preview requests cost zero; do not infer paid billing from the published future price.

## Documentation

- [First request](https://shvydko.ai/en/docs-markdown/quickstart.md): From a Playground example to a typed decision in your application.

- [Context and questions](https://shvydko.ai/en/docs-markdown/concepts/context.md): Separate facts from the decision rule. One context can answer several independent questions.

- [Choice](https://shvydko.ai/en/docs-markdown/primitives/choice.md): One named category from your options: a team, intent, route, or document class.

- [Score](https://shvydko.ai/en/docs-markdown/primitives/score.md): A numeric score on a scale whose levels you describe in words.

- [Noul](https://shvydko.ai/en/docs-markdown/primitives/noul.md): A statement score from 0 to 1: check whether a fact is present, a rule applies, or a condition is met.

- [POST /v1/systemone](https://shvydko.ai/en/docs-markdown/api/systemone.md): The request and response contract for Choice, Score, and Noul through one HTTP endpoint.

- [GET /v1/models](https://shvydko.ai/en/docs-markdown/api/models.md): Get the available model's name and context limits before integrating.

- [Keys and authentication](https://shvydko.ai/en/docs-markdown/api/authentication.md): Organization API keys for your server, one-time secret display, and access revocation.

- [Errors and retries](https://shvydko.ai/en/docs-markdown/api/errors.md): Distinguish validation errors, limits, insufficient reservation balance, and model unavailability.

- [Limits and context](https://shvydko.ai/en/docs-markdown/api/limits.md): Three different limits: JSON size, model tokens, and organization request rate.

- [The Shvydko model](https://shvydko.ai/en/docs-markdown/models.md): Typed decisions through one API. Capabilities, the current model card, and limitations.

- [Pricing and usage accounting](https://shvydko.ai/en/docs-markdown/pricing.md): Input-token pricing, one-time Stripe top-ups, reservations, and actual charges.

- [Decision confidence](https://shvydko.ai/en/docs-markdown/confidence.md): How to read probabilities, confidence, and Noul, and choose thresholds for your workflow.

- [How to evaluate the model](https://shvydko.ai/en/docs-markdown/evaluation.md): From a working example to a reproducible evaluation of quality, cost, and latency.

- [Python over HTTP](https://shvydko.ai/en/docs-markdown/integrations/python.md): A complete example using Python's standard library, with no separate SDK.

- [JavaScript over HTTP](https://shvydko.ai/en/docs-markdown/integrations/javascript.md): Server-side fetch with status checking and a timeout, keeping the API key out of the browser.

- [Shvydko for AI agents](https://shvydko.ai/en/docs-markdown/integrations/coding-agents.md): Give your agent the current contract, validate the request locally, and connect typed decisions to your server code.

- [Routing support requests](https://shvydko.ai/en/docs-markdown/patterns/routing.md): A practical workflow: classify a request, check confidence and retain a manual route.

## Other resources

- [Examples](https://shvydko.ai/en/examples): Runnable decision inputs, not customer outcome claims.

- [Comparison and limitations](https://shvydko.ai/en/compare): Versions, methodology and limitations beside the diagnostic result.

- [Terms](https://shvydko.ai/en/terms): Operator, credit and refund terms.

- [Privacy](https://shvydko.ai/en/privacy): Data processing and account information.