Installation and authentication with the 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()
   
   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.
   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.

​

What’s next