Chat / Completions
Generation, reasoning and text transformation in AI Studio. Pin the model version and validate structured output against a schema.
Developer Docs · Yandex AI
More than a model list: when you want AI Studio's chat models, embeddings or realtime speech — and when the right tool is a separate Yandex service: Wordstat, the Search API, OCR, Translate or SpeechKit. Plus an integration scheme that survives updates: pinned model versions, schema validation, and — for models that support it — an explicit reasoning and output budget.
Chat, embeddings and realtime live in AI Studio; Wordstat, the Search API, OCR, Translate and SpeechKit are separate Yandex services with their own APIs and documentation.
Generation, reasoning and text transformation in AI Studio. Pin the model version and validate structured output against a schema.
Vectors for search and retrieval. Changing model or version means rebuilding the index — vectors from different models are not comparable.
Live voice dialogue over WebSocket — or classic speech recognition and synthesis as a dedicated service.
Separate Yandex services: Wordstat for query frequency, dynamics and regional splits; the Search API for programmatic web results.
Text from photos, scans and PDFs. A dedicated recognition service with its own API — not a 'read this image' plea to a chat model.
A dedicated machine-translation service with glossary support — for consistent terminology, not a generative paraphrase of the meaning.
Yandex's platform for working with generative models: chat and completion models (including the YandexGPT family), embeddings for search and retrieval, and realtime speech interfaces. Around it sit separate Yandex services with their own APIs — Wordstat for Russian search statistics, the Search API for web results, OCR for text in images, Translate for machine translation with glossary control, and SpeechKit for speech recognition and synthesis. They are not features of one AI Studio API; this page maps each job to the right surface, whether it lives inside AI Studio or next to it.
Whenever the job has a specialist service — and each of these is its own Yandex service with its own API, not an AI Studio feature: Wordstat answers how often people search a query, with dynamics and regional splits; the Search API returns actual web results; OCR reads text from images and scans; Translate gives machine translation with glossary control; SpeechKit turns speech into text and back. A chat model can imitate each of these, less verifiably and with no ground truth behind the answer. Reach for the generative model when the job is generation, reasoning or transformation of text you provide.
For AI Studio's generative models, the official model list documents versions and lifecycle markers — which release is current, which is a release candidate, and which is deprecated. Pin the exact version the official list marks as current for anything users depend on, try pre-release versions only in staging, and treat a deprecation notice as a scheduled migration task. Adjacent services (OCR, Translate, SpeechKit and the rest) version differently — check each API's own reference rather than assuming one scheme.
Ask for it explicitly and verify it locally: where the model and API version support a structured-output option with a JSON Schema, use it — and validate every response against your schema before acting on it either way. Prompt-only JSON is a common failure point — models happily wrap it in Markdown fences or add a friendly sentence. The schema-plus-validation pair turns 'usually parses' into a contract.
Generation models spend tokens on the answer — and models that expose reasoning controls can also spend tokens thinking before the answer. Both draw on your maximum-output setting, so a simple job with a tight limit and reasoning enabled can burn the whole budget on hidden thinking and return almost nothing visible. For models and APIs that expose these controls, set the output limit deliberately, keep reasoning off or minimal for simple jobs, and reserve generous budgets for tasks that genuinely need multi-step thought.
Server-side keys, never in client code; a pinned model version in configuration; schema validation on every structured answer; explicit output limits per job; exponential backoff on rate limits; and logs that record request identifiers rather than user content. Start with one narrow job, measure quality and cost on your own data, then widen — the ecosystem is large, and adopting it service by service beats adopting it all at once.
The primary source is the official Yandex AI Studio documentation and the adjacent services' docs: model lists, aliases, prices and limits move — verify there before you start and again before release. Official documentation.