# GET /v1/models

Get the available model's name and context limits before integrating.

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

## Get the current model card

The endpoint requires a valid API key. It returns Shvydko's public name and current limits without running an evaluation. The same content is available to authenticated accounts via GET /api/models.

Pass models[0].name in the model field, or omit model to use the current version of the service.

### GET · Bearer API key

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

## What the fields mean

Context fields may be absent. Do not substitute invented values. If context contains max_state and max_branch, the former limits the shared state and the latter limits state together with an individual question branch.

strict: true in the context card means the service strictly enforces the limits. Even if a request fits the gateway's JSON limit, it may exceed the model's token context limit.

| Model field | Meaning |
| --- | --- |
| name | Public name for POST /v1/systemone |
| context | Current context limits, if provided by the service |

## Availability and version

HTTP 502 means the connected model's card could not be retrieved; 503 means the model service is not configured. A successful GET checks metadata availability, but does not measure inference quality or speed.

shvydko-latest refers to the current version of the service. It may be updated. If your workflow requires a fixed version, arrange this before launch; the public API currently has no separate parameter to pin one.

## Related documentation

- [The Shvydko model](https://shvydko.ai/en/docs-markdown/models.md)
- [Keys and authentication](https://shvydko.ai/en/docs-markdown/api/authentication.md)
- [Limits and context](https://shvydko.ai/en/docs-markdown/api/limits.md)