Nebius AI Cloud SDK for Go

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

​

Supported Go versions

​

Installation and update

go get github.com/nebius/gosdk

go get -u github.com/nebius/gosdk

​

Initialization and authentication

1. Create a service account.
2. Generate an authorized key and create a service account credentials file:
   nebius iam auth-public-key generate \
     --service-account-id <service_account_ID> \
     --output <credentials_file_path>
   
   In the command, set the following parameters:
   • --service-account-id: ID of your service account.
   • --output: Path to the service account credentials file, for example, credentials.json.
3. Initialize the SDK with the service account credentials file:
   import (
      "fmt"
   
      "github.com/nebius/gosdk"
      "github.com/nebius/gosdk/auth"
   )
   
   sdk, err := gosdk.New(
      ctx,
      gosdk.WithUserAgentPrefix("<application_name>/<application_version_or_comment>"),
      gosdk.WithCredentials(
         gosdk.ServiceAccountReader(
            auth.NewServiceAccountCredentialsFileParser(
               nil,
               "<credentials_file_path>",
            ),
         ),
      ),
   )
   if err != nil {
      return fmt.Errorf("create gosdk: %w", err)
   }
   defer sdk.Close()
   
   The gosdk.New constructor initializes the SDK and uses the service account credentials file to authenticate requests. The WithUserAgentPrefix method adds a prefix to the User-Agent header sent with each request. Use WithUserAgentPrefix 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.
   • <credentials_file_path>: Path to the service account credentials file.

​

Sending a request

1. Create a Go file with the following code. This script already includes SDK initialization and authentication.
   package main
   
   import (
      "context"
      "fmt"
   
      "github.com/nebius/gosdk"
      "github.com/nebius/gosdk/auth"
      common "github.com/nebius/gosdk/proto/nebius/common/v1"
      compute "github.com/nebius/gosdk/proto/nebius/compute/v1"
   )
   
   // Run the resource creation workflow.
   func main() {
      if err := CreateInstance(context.Background()); err != nil {
         panic(err)
      }
   }
   
   // CreateInstance creates a boot disk and a VM that uses it.
   func CreateInstance(ctx context.Context) error {
      // Initialize the SDK with service account credentials.
      sdk, err := gosdk.New(
         ctx,
         gosdk.WithUserAgentPrefix("<application_name>/<application_version_or_comment>"),
         gosdk.WithCredentials(
            gosdk.ServiceAccountReader(
               auth.NewServiceAccountCredentialsFileParser(
                  nil,
                  "<credentials_file_path>",
               ),
            ),
         ),
      )
      if err != nil {
         return fmt.Errorf("create gosdk: %w", err)
      }
      defer sdk.Close()
   
      // Create the boot disk.
      diskOperation, err := sdk.Services().Compute().V1().Disk().Create(ctx, &compute.CreateDiskRequest{
         Metadata: &common.ResourceMetadata{
            ParentId: "<project_ID>",
            Name:     "my-boot-disk",
         },
         Spec: &compute.DiskSpec{
            Size: &compute.DiskSpec_SizeGibibytes{
               SizeGibibytes: 93,
            },
            Type: compute.DiskSpec_NETWORK_SSD,
            Source: &compute.DiskSpec_SourceImageFamily{
               SourceImageFamily: &compute.SourceImageFamily{
                  ParentId:    "<project_ID>",
                  ImageFamily: "<image_family_name>",
               },
            },
         },
      })
      if err != nil {
         return fmt.Errorf("create disk: %w", err)
      }
   
      diskOperation, err = diskOperation.Wait(ctx)
      if err != nil {
         return fmt.Errorf("wait for disk create: %w", err)
      }
   
      // Create the VM that uses the boot disk.
      instanceOperation, err := sdk.Services().Compute().V1().Instance().Create(ctx, &compute.CreateInstanceRequest{
         Metadata: &common.ResourceMetadata{
            ParentId: "<project_ID>",
            Name:     "my-vm",
         },
         Spec: &compute.InstanceSpec{
            Resources: &compute.ResourcesSpec{
               Platform: "<platform_name>",
               Size: &compute.ResourcesSpec_Preset{
                  Preset: "<preset_name>",
               },
            },
            NetworkInterfaces: []*compute.NetworkInterfaceSpec{
               {
                  Name:      "eth0",
                  SubnetId:  "<subnet_ID>",
                  IpAddress: &compute.IPAddress{},
               },
            },
            BootDisk: &compute.AttachedDiskSpec{
               AttachMode: compute.AttachedDiskSpec_READ_WRITE,
               Type: &compute.AttachedDiskSpec_ExistingDisk{
                  ExistingDisk: &compute.ExistingDisk{
                     Id: diskOperation.ResourceID(),
                  },
               },
               DeviceId: "boot-disk",
            },
         },
      })
      if err != nil {
         return fmt.Errorf("create VM: %w", err)
      }
   
      _, err = instanceOperation.Wait(ctx)
      if err != nil {
         return fmt.Errorf("wait for VM creation: %w", err)
      }
   
      return nil
   }
   
   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.
   • <credentials_file_path>: Path to the service account credentials file.
   • <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:
   go run <file_name>.go