Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex AI Studio
    • About Yandex AI Studio
    • Yandex Workflows
    • Quotas and limits
    • Terms and definitions
  • Compatibility with OpenAI
    • About Yandex Cloud ML SDK
      • Overview
        • Overview
        • Models domain
        • Assistants domain
        • Tools domain
        • Files domain
        • Threads domain
        • Runs domain
        • Search indexes domain
        • Search API domain
        • Datasets domain
        • Tuning domain
        • Batch domain
        • Chat domain
      • Authentication
      • Request retries
  • Access management
  • Pricing policy
  • Audit Trails events
  • Public materials
  • Release notes
  1. Yandex Cloud ML SDK
  2. SDK reference
  3. Async SDK
  4. Overview

Async SDK

Written by
Yandex Cloud
Updated at November 7, 2025

class yandexcloudmlsdk.AsyncYCloudMLclass yandex_cloud_ml_sdk.AsyncYCloudML

The main class that needs to be instantiated to work with SDK.

tools: AsyncTools

Domain for creating various tools for assistants and function calling

models: AsyncModels

Domain for working with models (inference and tuning)

files: AsyncFiles

Domain for working with files (a part of the Asssistants API)

threads: AsyncThreads

Domain for working with threads (a part of the Assistants API)

assistants: AsyncAssistants

Domain for working with assistants (a part of the Assistants API)

runs: AsyncRuns

Domain for working with assistants’ runs (a part of the Assistants API)

search_api: AsyncSearchAPIDomain

Domain for working with Search API

search_indexes: AsyncSearchIndexes

Domain for working with search indexes (a part of the Assistants API)

datasets: AsyncDatasets

Domain for working with datasets

tuning: AsyncTuning

Domain for working with tuning

batch: AsyncBatch

Domain for working with batch tasks

chat: AsyncChat

Domain for working with Yandex Cloud OpenAI Compatible API_BaseSDK_URL.

__init__(*, folder_id=Undefined, endpoint=Undefined, auth=Undefined, retry_policy=Undefined, yc_profile=Undefined, service_map=Undefined, interceptors=Undefined, enable_server_data_logging=Undefined, verify=Undefined)

Construct a new asynchronous sdk instance.

Parameters

  • folder_id (str) – Yandex Cloud folder identifier which will be billed for models usage. In case of default Undefined value, the parameter will be taken from the environment variable YC_FOLDER_ID.
  • endpoint (str) – domain:port pair for Yandex Cloud API or any other grpc compatible target. In case of None passed it turns off service endpoint discovery mechanism and requires service_map to be passed.
  • auth (str | BaseAuth | Undefined) – string with API Key, IAM token or one of yandex_cloud_ml_sdk.auth objects; in case of default Undefined value, the token will be taken from one of the environment variables: YC_OAUTH_TOKEN, YC_TOKEN, YC_IAM_TOKEN, or YC_API_KEY.
  • service_map (Dict[str, str]) – a way to redefine endpoints for one or more cloud subservices with a format of dict {"service_name": "service_address"}.
  • enable_server_data_logging (bool | Undefined) – when passed bool, we will add x-data-logging-enabled: to all of requests, which will enable or disable logging of user data on server side. It will do something only on those parts of backends which supports this option.
  • verify (bool | pathlib.Path | str | os.PathLike) – SSL certificates (a.k.a CA bundle) used to verify the identity of requested hosts. Either True (default CA bundle), a path to an SSL certificate file, or False (which will disable verification).
  • retry_policy (RetryPolicy | Undefined)
  • yc_profile (str | Undefined)
  • interceptors (Sequence[ClientInterceptor] | Undefined)

setup_default_logging(log_level='INFO', log_format='[%(levelname)1.1s %(asctime)s %(name)s:%(lineno)d] %(message)s', date_format='%Y-%m-%d %H:%M:%S')

Sets up the default logging configuration.

Read more about log_levels, log_format, and date_format in Python documentation (logging).

Parameters

  • log_level (Literal['CRITICAL', 'FATAL', 'ERROR', 'WARN', 'WARNING', 'INFO', 'DEBUG', 'TRACE'] | ~typing.Literal['critical', 'fatal', 'error', 'warn', 'warning', 'info', 'debug', 'TRACE'] | int) – The logging level to set.
  • log_format (str) – The format of the log messages.
  • date_format (str) – The format for timestamps in log messages.

Returns

The instance of the SDK with logging configured.

Return type

Self

  • Models domain
    • AsyncModels
      • AsyncModels.completions
      • AsyncModels.text_embeddings
      • AsyncModels.text_classifiers
      • AsyncModels.image_generation
  • Assistants domain
    • AsyncAssistants
      • AsyncAssistants.create()
      • AsyncAssistants.get()
      • AsyncAssistants.list()
    • AsyncAssistant
      • AsyncAssistant.update()
      • AsyncAssistant.delete()
      • AsyncAssistant.list_versions()
      • AsyncAssistant.run()
      • AsyncAssistant.run_stream()
      • AsyncAssistant.max_prompt_tokens
      • AsyncAssistant.name
      • AsyncAssistant.description
      • AsyncAssistant.created_by
      • AsyncAssistant.created_at
      • AsyncAssistant.updated_by
      • AsyncAssistant.updated_at
      • AsyncAssistant.expires_at
      • AsyncAssistant.labels
      • AsyncAssistant.expiration_config
      • AsyncAssistant.model
      • AsyncAssistant.instruction
      • AsyncAssistant.prompt_truncation_options
      • AsyncAssistant.tools
      • AsyncAssistant.response_format
      • AsyncAssistant.id
  • Tools domain
    • AsyncTools
      • AsyncTools.function
      • AsyncTools.generative_search()
      • AsyncTools.rephraser
      • AsyncTools.search_index()
    • Types
      • AsyncToolCall
        • AsyncToolCall.id
        • AsyncToolCall.function
      • AsyncFunctionCall
        • AsyncFunctionCall.name
        • AsyncFunctionCall.arguments
  • Files domain
    • AsyncFiles
      • AsyncFiles.upload_bytes()
      • AsyncFiles.upload()
      • AsyncFiles.get()
      • AsyncFiles.list()
    • AsyncFile
      • AsyncFile.get_url()
      • AsyncFile.update()
      • AsyncFile.delete()
      • AsyncFile.download_as_bytes()
      • AsyncFile.name
      • AsyncFile.description
      • AsyncFile.mime_type
      • AsyncFile.created_by
      • AsyncFile.created_at
      • AsyncFile.updated_by
      • AsyncFile.updated_at
      • AsyncFile.expires_at
      • AsyncFile.labels
      • AsyncFile.expiration_config
      • AsyncFile.id
  • Threads domain
    • AsyncThreads
      • AsyncThreads.create()
      • AsyncThreads.get()
      • AsyncThreads.list()
    • AsyncThread
      • AsyncThread.update()
      • AsyncThread.delete()
      • AsyncThread.write()
      • AsyncThread.read()
      • AsyncThread.name
      • AsyncThread.description
      • AsyncThread.created_by
      • AsyncThread.created_at
      • AsyncThread.updated_by
      • AsyncThread.updated_at
      • AsyncThread.expires_at
      • AsyncThread.labels
      • AsyncThread.expiration_config
      • AsyncThread.id
  • Runs domain
    • AsyncRuns
      • AsyncRuns.get()
      • AsyncRuns.get_last_by_thread()
      • AsyncRuns.list()
    • AsyncRun
      • AsyncRun.listen()
      • AsyncRun.submit_tool_results()
      • AsyncRun.cancel()
      • AsyncRun.custom_max_prompt_tokens
      • AsyncRun.get_result()
      • AsyncRun.get_status()
      • AsyncRun.wait()
      • AsyncRun.id
      • AsyncRun.assistant_id
      • AsyncRun.thread_id
      • AsyncRun.created_by
      • AsyncRun.created_at
      • AsyncRun.labels
      • AsyncRun.custom_temperature
      • AsyncRun.custom_max_tokens
      • AsyncRun.custom_prompt_truncation_options
      • AsyncRun.custom_response_format
  • Search indexes domain
    • AsyncSearchIndexes
      • AsyncSearchIndexes.create_deferred()
      • AsyncSearchIndexes.get()
      • AsyncSearchIndexes.list()
    • AsyncSearchIndex
      • AsyncSearchIndex.update()
      • AsyncSearchIndex.delete()
      • AsyncSearchIndex.get_file()
      • AsyncSearchIndex.list_files()
      • AsyncSearchIndex.add_files_deferred()
      • AsyncSearchIndex.folder_id
      • AsyncSearchIndex.name
      • AsyncSearchIndex.description
      • AsyncSearchIndex.created_by
      • AsyncSearchIndex.created_at
      • AsyncSearchIndex.updated_by
      • AsyncSearchIndex.updated_at
      • AsyncSearchIndex.expires_at
      • AsyncSearchIndex.labels
      • AsyncSearchIndex.index_type
      • AsyncSearchIndex.expiration_config
      • AsyncSearchIndex.id
  • Search API domain
    • AsyncSearchAPIDomain
      • AsyncSearchAPIDomain.generative
      • AsyncSearchAPIDomain.web
      • AsyncSearchAPIDomain.image
      • AsyncSearchAPIDomain.by_image
    • Generative search
      • AsyncGenerativeSearchFunction
        • AsyncGenerativeSearchFunction.__call__()
        • AsyncGenerativeSearchFunction.available_formats
      • AsyncGenerativeSearch
        • AsyncGenerativeSearch.run()
        • AsyncGenerativeSearch.as_tool()
        • AsyncGenerativeSearch.config
        • AsyncGenerativeSearch.configure()
        • AsyncGenerativeSearch.uri
    • Web search
      • AsyncWebSearchFunction
        • AsyncWebSearchFunction.__call__()
      • AsyncWebSearch
        • AsyncWebSearch.run()
        • AsyncWebSearch.run_deferred()
        • AsyncWebSearch.config
        • AsyncWebSearch.configure()
        • AsyncWebSearch.uri
      • AsyncWebSearchResult
        • AsyncWebSearchResult.next_page()
        • AsyncWebSearchResult.next_page_deferred()
        • AsyncWebSearchResult.count()
        • AsyncWebSearchResult.docs
        • AsyncWebSearchResult.index()
        • AsyncWebSearchResult.xml
        • AsyncWebSearchResult.groups
        • AsyncWebSearchResult.page
    • Image search
      • AsyncImageSearchFunction
        • AsyncImageSearchFunction.__call__()
      • AsyncImageSearch
        • AsyncImageSearch.run()
        • AsyncImageSearch.config
        • AsyncImageSearch.configure()
        • AsyncImageSearch.uri
      • AsyncImageSearchResult
        • AsyncImageSearchResult.next_page()
        • AsyncImageSearchResult.count()
        • AsyncImageSearchResult.docs
        • AsyncImageSearchResult.index()
        • AsyncImageSearchResult.xml
        • AsyncImageSearchResult.groups
        • AsyncImageSearchResult.page
    • Search by image
      • AsyncByImageSearchFunction
        • AsyncByImageSearchFunction.__call__()
      • AsyncByImageSearch
        • AsyncByImageSearch.run()
        • AsyncByImageSearch.run_from_url()
        • AsyncByImageSearch.run_from_id()
        • AsyncByImageSearch.config
        • AsyncByImageSearch.configure()
        • AsyncByImageSearch.uri
      • AsyncByImageSearchResult
        • AsyncByImageSearchResult.next_page()
        • AsyncByImageSearchResult.count()
        • AsyncByImageSearchResult.docs
        • AsyncByImageSearchResult.index()
        • AsyncByImageSearchResult.images
        • AsyncByImageSearchResult.cbir_id
        • AsyncByImageSearchResult.page
  • Datasets domain
    • AsyncDatasets
      • AsyncDatasets.get()
      • AsyncDatasets.list()
      • AsyncDatasets.list_upload_formats()
      • AsyncDatasets.list_upload_schemas()
      • AsyncDatasets.completions
      • AsyncDatasets.draft_from_path()
      • AsyncDatasets.text_classifiers_binary
      • AsyncDatasets.text_classifiers_multiclass
      • AsyncDatasets.text_classifiers_multilabel
      • AsyncDatasets.text_embeddings_pair
      • AsyncDatasets.text_embeddings_triplet
    • AsyncDataset
      • AsyncDataset.update()
      • AsyncDataset.delete()
      • AsyncDataset.list_upload_formats()
      • AsyncDataset.download()
      • AsyncDataset.read()
      • AsyncDataset.folder_id
      • AsyncDataset.name
      • AsyncDataset.description
      • AsyncDataset.metadata
      • AsyncDataset.created_by
      • AsyncDataset.created_at
      • AsyncDataset.updated_at
      • AsyncDataset.labels
      • AsyncDataset.allow_data_logging
      • AsyncDataset.status
      • AsyncDataset.task_type
      • AsyncDataset.rows
      • AsyncDataset.size_bytes
      • AsyncDataset.validation_errors
      • AsyncDataset.id
    • AsyncDatasetDraft
      • AsyncDatasetDraft.upload_deferred()
      • AsyncDatasetDraft.upload()
      • AsyncDatasetDraft.allow_data_logging
      • AsyncDatasetDraft.configure()
      • AsyncDatasetDraft.description
      • AsyncDatasetDraft.labels
      • AsyncDatasetDraft.metadata
      • AsyncDatasetDraft.name
      • AsyncDatasetDraft.path
      • AsyncDatasetDraft.task_type
      • AsyncDatasetDraft.upload_format
      • AsyncDatasetDraft.validate()
  • Tuning domain
    • AsyncTuning
      • AsyncTuning.get()
      • AsyncTuning.list()
  • Batch domain
    • AsyncBatch
      • AsyncBatch.get()
      • AsyncBatch.list_operations()
      • AsyncBatch.list_info()
    • AsyncBatchTaskOperation
      • AsyncBatchTaskOperation.delete()
      • AsyncBatchTaskOperation.get_task_info()
      • AsyncBatchTaskOperation.cancel()
      • AsyncBatchTaskOperation.get_result()
      • AsyncBatchTaskOperation.get_status()
      • AsyncBatchTaskOperation.id
      • AsyncBatchTaskOperation.task_id
      • AsyncBatchTaskOperation.wait()
  • Chat domain
    • AsyncChat
      • AsyncChat.completions
      • AsyncChat.text_embeddings

Was the article helpful?

Previous
Chat domain
Next
Models domain
© 2025 Direct Cursus Technology L.L.C.