API
Images
Overview

Images

Images are templates used to create compute instances.

An image can be a public base OS (like Ubuntu or CirrOS) or a private image owned by your project.


Concepts

Image ID

When you create an instance, you reference an image by its id:

  • id — unique image identifier
  • name — short name (e.g. ubuntu24.04)
  • visibilitypublic or private

Metadata

Some images include additional metadata (for example, if an image was created from an instance snapshot).


Endpoints


Authentication

Image endpoints require an API key:

x-api-key: YOUR_API_KEY

See Authentication for examples in cURL, Node.js, Python, and Go.