How to create an API key for accessing Yandex Cloud AI Studio

Yandex Cloud AI Studio is part of Yandex Cloud and uses its authentication and authorization mechanism. You can send API requests to AI Studio, Yandex Translate, Yandex Vision OCR, or SpeechKit models under your user account by authenticating with an IAM token. This is the most secure way to do a quick trial as the IAM token lifetime is limited to 12 hours.

We recommend accessing the API as a service account with an API key.

To create an API key:

AI Studio UI

In the AI Studio interface, click Create API key in the top-right corner.
Optionally, change the description of the API key so you can easily find the key later.
Select the API key expiration date.
Click Create.
Save the ID and secret key.

Alert

Do not share your API key with anyone. After you close this dialog, the key value will no longer be available.

This will automatically create a service account holding the minimum required roles and an associated API key with the required scope for accessing all components and services across AI Studio.

What roles a service account gets

Once created, such a service account holds the following roles:

Role	Description
`ai.editor`	Access to Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex Cloud AI Studio
`serverless.mcpGateways.invoker`	Access to MCP servers, including via MCP Hub
`serverless.mcpGateways.anonymousInvoker`	Access to external MCP servers
`serverless.workflows.executor`	Access to Yandex Workflows workflow execution
`search-api.webSearch.user`	Access to Yandex Search API via API v2

What scope the API key gets

Once created, such an API key has the following scopes:

Scope	Description
`yc.ai.imageGeneration.execute`	Access to image generation
`yc.ai.languageModels.execute`	Access to text generation by Model Gallery models
`yc.ai.speechkitStt.execute`	Access to speech recognition
`yc.ai.speechkitTts.execute`	Access to speech synthesis
`yc.ai.translate.execute`	Access to text translation
`yc.ai.vision.execute`	Access to image analysis
`yc.search-api.execute`	Access to Yandex Search API
`yc.serverless.containers.invoke`	Access to container invocation
`yc.serverless.functions.invoke`	Access to function calling

You can now send requests to all service APIs across AI Studio using the created API key.

Was the article helpful?

FAQ

Disabling request logging