Skip to navigation
API ReferenceGPU Cloud

Connect with SSH

Add your public key to the account (like POST /v1/gpu/ssh-keys), prepare SSH inside this running instance’s workload with it, and receive the command to connect: ssh -J ssh.empiriolabs.ai:<port> root@gpu-<instance_id>.

This call is optional. Any key on your account connects with that command directly; the first connection to an instance then takes a minute longer while SSH is prepared. SSH has no separate charge. Agent, X11, and port forwarding are disabled.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Path parameters

instance_idstringRequiredformat: "^[0-9a-f]{16}$"
GPU instance id.

Request

This endpoint expects an object.
public_keystringRequired<=8192 characters

A single-line ssh-ed25519 or ssh-rsa public key, without options or line breaks. RSA keys must be 2048 to 8192 bits.

Response

SSH is prepared. Run command to connect.

commandstring
The OpenSSH command for this instance.
sshobject
How to connect to the instance with OpenSSH while it is running.
keyobject
The account key this call added or found.
ticketstringOptionalDeprecated

Retained for existing integrations of the earlier WebSocket transport. Use command.

expires_inintegerOptional1-120Deprecated

Lifetime of ticket in seconds.

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error
413
Content Too Large Error
422
Unprocessable Entity Error
429
Too Many Requests Error
503
Service Unavailable Error