vust

Developer Docs · Yandex AI

Yandex AI Studio: the Right Service for the Job

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.

6 service classes · chosen by job, not by hypeAn independent guide built on the official documentation
AI Studio: generation, vectors and realtime speechSchema validation and an explicit output budget from day oneWordstat, Search API, OCR, Translate and SpeechKit — separate services for specialist jobs

Choose the service by job

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.

Chat / Completions

Generation, reasoning and text transformation in AI Studio. Pin the model version and validate structured output against a schema.

Embeddings

Vectors for search and retrieval. Changing model or version means rebuilding the index — vectors from different models are not comparable.

Realtime and SpeechKit

Live voice dialogue over WebSocket — or classic speech recognition and synthesis as a dedicated service.

Wordstat and the Search API

Separate Yandex services: Wordstat for query frequency, dynamics and regional splits; the Search API for programmatic web results.

OCR

Text from photos, scans and PDFs. A dedicated recognition service with its own API — not a 'read this image' plea to a chat model.

Translate

A dedicated machine-translation service with glossary support — for consistent terminology, not a generative paraphrase of the meaning.

The safe integration scheme

  • Keys live server-side; they never enter client code, logs or repositories.
  • For AI Studio's generative models, production pins the version the official list marks as current; pre-release versions belong in staging, and deprecated means a migration plan. Adjacent services follow their own versioning.
  • Every structured answer is validated against a JSON Schema before use — 'usually parses' is not a contract.
  • For models that expose reasoning controls, the output budget is set per job: minimal reasoning and tight limits for simple jobs, deliberately generous ones for genuinely hard tasks.
  • Specialist jobs go to specialist services: OCR, translation and speech carry a documented response contract where a chat model gives a paraphrase.
  • Before release, re-check the model list, prices and schemas against the official documentation — the platform moves fast.

Frequently asked questions

What is Yandex AI Studio, in one paragraph?

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.

When should I use Wordstat, the Search API, OCR, Translate or SpeechKit instead of a chat model?

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.

How do I pick a model version safely?

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.

How do I get reliable structured output?

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.

What is a reasoning/output budget and why set it?

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.

What does a safe first integration look like?

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.