Nebius AI Cloud SDK for Python

• Nebius AI Cloud repository for the Python SDK
• Python SDK reference

​

Supported Python versions

​

Installation and update

python3 -m pip install nebius

python3 -m pip install -U nebius

​

Initialization and authentication

1. Create a service account.
2. Create a private and public key pair:
   openssl genrsa -out private.pem 4096 && \
   openssl rsa -in private.pem -outform PEM -pubout -out public.pem
   
   This command creates the private.pem and public.pem files in the current directory.
3. Upload the public key to create an authorized key:
   nebius iam auth-public-key create \
     --account-service-account-id <service_account_ID> \
     --data "$(cat public.pem)"
   
   In the command, specify the service account ID.
4. Initialize the SDK with the private key file:
   from nebius.sdk import SDK
   
   sdk = SDK(
       user_agent_prefix="<application_name>/<application_version_or_comment>",
       service_account_private_key_file_name="<private_key_file_path>",
       service_account_public_key_id="<public_key_ID>",
       service_account_id="<service_account_ID>",
   )
   
   The SDK constructor initializes the SDK and uses the service account private key file to authenticate requests. The user_agent_prefix argument adds a prefix to the User-Agent header sent with each request. Use user_agent_prefix to identify your application in the list of requests. In the script, set the following parameters:
   • <application_name>/<application_version_or_comment>: Application or library that calls the SDK. The version or comment is optional.
   • <private_key_file_path>: Path to the private key file, for example private.pem.
   • <public_key_ID>: ID of the public key generated for the service account.
   • <service_account_ID>: ID of your service account.

​

Sending a request

1. Create a Python file with the following code. This script already includes SDK initialization and authentication.
   import asyncio
   
   from nebius.api.nebius.common.v1 import ResourceMetadata
   from nebius.api.nebius.compute.v1 import (
       AttachedDiskSpec,
       CreateDiskRequest,
       CreateInstanceRequest,
       DiskServiceClient,
       DiskSpec,
       ExistingDisk,
       InstanceServiceClient,
       InstanceSpec,
       IPAddress,
       NetworkInterfaceSpec,
       ResourcesSpec,
       SourceImageFamily,
   )
   from nebius.sdk import SDK
   
   
   async def create_instance() -> None:
       # Initialize the SDK with the service account private key file.
       sdk = SDK(
           user_agent_prefix="<application_name>/<application_version_or_comment>",
           service_account_private_key_file_name="<private_key_file_path>",
           service_account_public_key_id="<public_key_ID>",
           service_account_id="<service_account_ID>",
       )
   
       async with sdk:
           disk_service = DiskServiceClient(sdk)
           instance_service = InstanceServiceClient(sdk)
   
           # Create the boot disk.
           disk_operation = await disk_service.create(
               CreateDiskRequest(
                   metadata=ResourceMetadata(
                       parent_id="<project_ID>",
                       name="my-boot-disk",
                   ),
                   spec=DiskSpec(
                       size_gibibytes=93,
                       type=DiskSpec.DiskType.NETWORK_SSD,
                       source_image_family=SourceImageFamily(
                           image_family="<image_family_name>",
                       ),
                   ),
               )
           )
   
           await disk_operation.wait()
   
           # Create the VM that uses the boot disk.
           instance_operation = await instance_service.create(
               CreateInstanceRequest(
                   metadata=ResourceMetadata(
                       parent_id="<project_ID>",
                       name="my-vm",
                   ),
                   spec=InstanceSpec(
                       resources=ResourcesSpec(
                           platform="<platform_name>",
                           preset="<preset_name>",
                       ),
                       network_interfaces=[
                           NetworkInterfaceSpec(
                               name="eth0",
                               subnet_id="<subnet_ID>",
                               ip_address=IPAddress(),
                           ),
                       ],
                       boot_disk=AttachedDiskSpec(
                           attach_mode=AttachedDiskSpec.AttachMode.READ_WRITE,
                           existing_disk=ExistingDisk(
                               id=disk_operation.resource_id,
                           ),
                           device_id="boot-disk",
                       ),
                   ),
               )
           )
   
           await instance_operation.wait()
   
   
   if __name__ == "__main__":
       asyncio.run(create_instance())
   
   In the script, set the following parameters:
   • <application_name>/<application_version_or_comment>: Application or library that calls the SDK. For more information, see Initialization and authentication.
   • <private_key_file_path>: Path to the private key file.
   • <public_key_ID>: ID of the public key generated for the service account.
   • <service_account_ID>: ID of your service account.
   • <project_ID>: ID of the project where you create the resources.
   • <image_family_name>: Name of the boot disk image family, for example, ubuntu24.04-driverless.
   • <platform_name>: Name of the Compute platform, for example, cpu-e2.
   • <preset_name>: Name of the resource preset. Available presets depend on the selected platform, for example, 2vcpu-8gb for cpu-e2.
   • <subnet_ID>: ID of the subnet for the VM.
2. Execute the file:
   python3 <file_name>.py