# The Shvydko model

Typed decisions through one API. Capabilities, the current model card, and limitations.

Source: https://shvydko.ai/en/docs/models

## Current configuration

Runtime values are not frozen in this document. Read GET https://shvydko.ai/api/config for the current service mode, pricing and gateway limits. Read authenticated GET /v1/models for model context limits. Configuration alone does not prove inference availability.

## Suitable tasks

Shvydko takes context and questions and returns Choice, Score, or Noul. Typical tasks include routing support requests, classifying documents, scoring relevance, and checking conditions.

The API works with text and JSON context. It does not provide open-ended chat generation, web search, agent tools, images, or Box. For a multi-step workflow, your application combines several decisions with its own data and actions.

- [Example tasks](https://shvydko.ai/en/examples)

## Available model card

GET /v1/models returns the connected service's actual model card, including context when available. The name in the current configuration panel is the configured alias; having a configuration does not prove that inference is currently working.

The public name may remain the same after a service update. Selecting a separate fixed version through this API is not currently supported.

### Get current metadata

```bash
curl --fail-with-body "$SHVYDKO_BASE_URL/v1/models" \
  -H "Authorization: Bearer $SHVYDKO_API_KEY"
```

## Quality depends on the task

A valid JSON structure does not mean the decision is correct. Evaluate each required language separately, including English and Ukrainian, along with ambiguous wording, new categories, and your domain's context on your own labeled dataset.

Demo runs show the integration and response format in action. They do not establish overall accuracy, probability calibration, or superiority over another model. Individual research comparisons have their own datasets and limits on their findings.

- [Comparisons and measurement limitations](https://shvydko.ai/en/compare)

## Before using it in a workflow

- Record the version of your criteria, your test dataset, and your rule for handing cases to a person.
- Check current context limits and behavior when they are exceeded.
- Measure latency and the error rate under your own workload.
- Do not use the model as the sole basis for a consequential, irreversible decision.

## Related documentation

- [GET /v1/models](https://shvydko.ai/en/docs-markdown/api/models.md)
- [Decision confidence](https://shvydko.ai/en/docs-markdown/confidence.md)
- [How to evaluate the model](https://shvydko.ai/en/docs-markdown/evaluation.md)
- [Pricing and usage accounting](https://shvydko.ai/en/docs-markdown/pricing.md)