# Oiy AI Documentation

> Developer preview of simple, container-level elastic GPU compute. Guides follow the current implementation; availability depends on the deployed version, capacity, and account eligibility.


- **GET STARTED**
- [Welcome to Oiy AI](/docs): Simple, container-level elastic GPU compute. Deploy, scale, and pay for usage.
- [Elastic GPU containers](/docs/elastic-containers): A Docker-like workflow with resource resizing, scale-to-zero, and usage-based billing.
- [Deploy your first container](/docs/quickstart): Choose an image, launch GPU compute, and configure scale-to-zero.
- [Deploy an HTTP container](/docs/http-quickstart): Create a service with curl, access its endpoint, and pause and resume compute.
- [Run a GPU notebook](/docs/gpu-notebook): Open the PyTorch starter, verify CUDA, save a result, and resume your workspace.
- [Preview and availability](/docs/preview): A precise description of what this developer preview does and does not promise.

- **BUILD**
- [Compute and GPU profiles](/docs/compute): Choose memory, GPU count, CPU, and system RAM for a service.
- [Regions and geography](/docs/placement): Select a service tier independently from the location of its data.
- Services
  - [Services](/docs/services): A stateful container, a workspace, and an explicit lifecycle.
  - [Container configuration](/docs/services/configuration): Configure images, commands, environment variables, ports, and storage.
  - [Reuse service settings](/docs/services/reuse): Rename a service, prepare duplicate settings, or save a portable template.
  - [Restart a service](/docs/services/restart): Replace allocated compute while preserving service identity, configuration, and workspace.
  - [Scale to zero, wake, and task protection](/docs/services/sleep): Release idle compute without mistaking a quiet task for a finished one.
  - [HTTP and browser access](/docs/services/endpoints): Connect to a service without exposing an anonymous public endpoint.
  - [Logs and commands](/docs/services/logs): Inspect your service and run bounded diagnostic commands.
  - [Resource monitoring](/docs/services/monitoring): Read CPU, memory, GPU, and VRAM measurements without changing service activity.
- [Persistent storage](/docs/storage): Understand ownership, attachment, expansion, deletion, and charges.
- [Templates](/docs/templates): Reuse container configurations without copying secret values.
- [Private container images](/docs/private-images): Use account-owned pull credentials for an exact OCI repository.
- [Billing and pricing](/docs/billing): Prepaid USD balance, allocation-based compute, and retained storage.
- [Billing history and usage reports](/docs/billing-history): Explore complete ledger windows, resource charges, pagination, and page exports.

- **DEVELOP**
- Developer tools
  - [Developer tools](/docs/developers): One API, with interfaces for the console, Python, command line, and AI clients.
  - [Python SDK](/docs/developers/python): Install from source and protect a running task from idle sleep.
  - [Command-line interface](/docs/developers/cli): Inspect services, adjust resources, and protect a subprocess.
  - [MCP server](/docs/developers/mcp): Connect a compatible AI client to Oiy services, storage, and templates.
- API reference
  - [HTTP API](/docs/api): Authentication, idempotency, errors, and asynchronous operation conventions.
  - [Authentication and API keys](/docs/api/authentication): Use account-scoped keys without exposing credentials to your workloads.
  - [Service API](/docs/api/services): Create a container service and control its lifecycle.
  - [Storage API](/docs/api/storage): Create, read, rename, expand, and delete independent volumes.
  - [Template API](/docs/api/templates): Read starter templates and maintain reusable account configurations.
  - [Image access API](/docs/api/images): Create, rotate, inspect, and remove exact-repository pull access.
  - [Billing API](/docs/api/billing): Read complete billing history and understand hosted Checkout authentication and reconciliation.
  - [OpenAPI description](/docs/api/openapi): Download the machine-readable contract for the current account-facing API operations.

- **SUPPORT**
- [Troubleshooting](/docs/troubleshooting): Diagnose the common gaps between a valid request and a working workload.

## Machine-readable resources

- [Complete documentation](https://docs.oiy.ai/llms-full.txt): All public guides in one text response.
- [OpenAPI 3.1](https://docs.oiy.ai/openapi.json): Account-facing control API schemas.

Each guide is also available as Markdown: append .md to its path, or use /docs/index.md for the welcome page. Request Accept: text/markdown on a guide URL to discover its Markdown representation.