Installation and authentication with the Nebius AI Cloud SDK for JavaScript

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

​

Supported Node.js versions

​

Installation and update

npm install @nebius/js-sdk

npm install @nebius/js-sdk@latest

​

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 { SDK } from '@nebius/js-sdk';
   import { CredentialsFileReader } from '@nebius/js-sdk/runtime/service_account/credentials_file';
   
   const sdk = new SDK({
     userAgentPrefix: '<application_name>/<application_version_or_comment>',
     credentials: new CredentialsFileReader('<credentials_file_path>'),
   });
   
   await 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 SDK constructor initializes the SDK and uses the service account credentials file to authenticate requests. The userAgentPrefix argument adds a prefix to the User-Agent header sent with each request. Use userAgentPrefix to identify your application in the list of requests.

​

What’s next