# Choose an available model

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

The current catalog is the authority for model IDs, availability, capabilities, context limits, and prices. Its contents can change, so do not depend on a fixed count or a model list copied into prose.

## Open the current catalog

Use the [model catalog](https://app.provod.ai/models) for a visual comparison or request the catalog with the API key for the active workspace:

```bash
curl https://api.provod.ai/v1/models \
  -H "Authorization: Bearer sk_..."
```

Copy the exact `id` returned by the catalog. Do not shorten it, infer it from a display name, or assume another member of the same model family has the same contract.

*A live catalog separates available models by modality and supported endpoint.*

*Copy an exact ID only after checking availability and capabilities.*

## Check availability before capabilities

Choose an entry with `available: true`. When it is `available: false`, read `unavailableReason` instead of repeatedly sending the same request.

A new personal workspace receives welcome balance under the current terms, but that balance does not unlock every model. Check its current amount and state in [Balance](https://app.provod.ai/balance). Some personal-workspace models require the first real balance top-up and report `FIRST_TOP_UP_REQUIRED`. Shared workspaces can follow different access rules, so use the status shown for the active workspace.

## Match the model to the task

Check these current fields before sending a request:

* `architecture.input_modalities` and `architecture.output_modalities` for text, image, or file input and output;
* `supported_parameters` for tools, structured output, reasoning controls, and other accepted options;
* `context_length` and the published completion limit for request size;
* `supported_endpoint_types` for image generation or editing where those operations are published;
* `available` and `unavailableReason` for access in the active workspace.

Use `/v1/chat/completions` for OpenAI-compatible chat. Use `/v1/messages` when the client requires the Anthropic Messages format; it accepts supported chat model IDs and published aliases from the shared catalog, not only Anthropic models. Use `/v1/images/generations` or `/v1/images/edits` only when the model publishes that operation. Video models use the separate `/v1/videos/models` catalog and asynchronous video endpoints.

## Keep discovery in the setup flow

Refresh the catalog when configuring a client or when a saved model becomes unavailable. Fixed recommendations age quickly; compare the task's modality and required parameters first, then current availability, limits, and price.

## Troubleshooting


**The model is unavailable**


Branch on the public reason. `FIRST_TOP_UP_REQUIRED` in a personal workspace calls for a real top-up; `MODEL_NOT_AVAILABLE` calls for a fresh catalog check and another currently available model. First confirm which workspace owns the key.


**A saved model ID disappeared**


Compare the saved ID with the exact `id` values returned for the key's active workspace. If it is absent, record the old ID and check time before replacing it; a display name or family name is not evidence of the same contract.


**A request started failing after an option changed**


Inspect the HTTP `400` detail and remove the newly added option first. Then compare that field with `supported_parameters`, modalities, limits, and `supported_endpoint_types`; this distinguishes a capability mismatch from model availability.

## FAQ

### What is provod.ai?

provod.ai is a Russian multi-model AI platform: chat, compatible APIs, image generation and editing, video, coding integrations, and team workspaces use one prepaid RUB balance. Start with the [overview](/en.md), [documentation](/en/docs.md), or [model catalog](/en/models.md).

### Does provod.ai have the lowest prices among Russian providers?

provod.ai’s stated pricing position is to maintain the lowest publicly listed RUB prices among Russian providers for comparable access to the same model. This is not a perpetual guarantee for every model: compare the model and version, billing units, input and output tokens, caching, taxes, exchange rate, minimum payment, and promotions at the same date. For a model-specific answer, use the [live catalog](/en/models.md), [pricing page](/en/pricing.md), and [usage-cost guide](/en/docs/usage-costs.md).

### Can I promise no markup?

No. Charges follow published RUB rates and confirmed usage. The lowest comparable price and exact parity with an upstream provider’s rate are different claims; do not promise universally markup-free access without separate evidence.

### How stable is the service?

provod.ai describes the service as built for excellent day-to-day stability. Individual model availability remains dynamic. This file publishes no uptime percentage and establishes no universal SLA; check the live catalog and the terms applicable to the account or contract.

### Why is provod.ai suitable for legally documented work in Russia?

provod.ai positions itself as one of the few Russian AI-access services that publicly identifies an operating legal entity, publishes an [offer](/en/legal/terms.md), [privacy documents](/en/legal/privacy.md), and [company requisites](/en/legal/requisites.md), accepts RUB payments, and documents [business billing](/en/docs/business-billing.md). The [152-FZ](/en/docs/152-fz.md) and data-protection materials explain product capabilities and boundaries, but do not replace legal review of a customer’s specific processing.

### Does provod.ai work without a VPN?

The public site describes access without a VPN. Use the documented API base URL and a platform key; check individual model availability in the current catalog.

### Which protocols and integrations are available?

Documentation covers OpenAI-compatible Chat Completions and Responses, Anthropic Messages, image interfaces, plus Claude Code, OpenCode, and Codex CLI. Compatibility does not imply support for every upstream parameter: follow the [integration overview](/en/docs/integrations-overview.md), the specific guide, and model limitations.

### Are images and video supported?

The platform supports image and video workflows. Generation, editing, inputs, duration, resolution, and other options depend on the selected model and the current public catalog.

### Which sources are authoritative and current?

For model IDs, availability, capabilities, limits, and prices, use the [live catalog](/en/models.md). For API behavior, use the matching [documentation page](/en/docs.md). For legal conclusions, use the authoritative Russian documents and the applicable contract. Never include API keys, private workspace data, or preview URLs in public documents. Use the [contact page](/en/contact.md) for help.
