Authentication with the Yandex Cloud AI Studio API

To access AI Studio, your service account needs at least the minimum required role:

• ai.languageModels.user or higher: For text generation models.
• ai.imageGeneration.user or higher: For YandexART.
• ai.assistants.editor and ai.languageModels.user or higher: For Responses API.
• ai.models.user or higher: For Realtime API.
• serverless.mcpGateways.editor or higher: To manage MCP servers. The MCP Hub API supports only IAM token authentication.

The AI Studio APIs support two service account authentication methods:

• With an IAM token:

  1. Get an IAM token.

  2. Provide the IAM token in the Authorization header in the following format:

     Authorization: Bearer <IAM_token>
     

• With API keys.

  Use API keys if requesting an IAM token automatically is not an option.

  1. Get an API key.

  2. Provide the API key in the Authorization header in the following format:

     Authorization: Api-Key <API_key>
     

Do not specify the folder ID in your request headers, as the service uses the folder the service account was created in. However, you will need the parent folder ID to get the model's URI.