Inicio rápido

1. Crea una clave API

Inicia sesión, abre Panel → Claves API, y crea una clave. Copia el secreto — se muestra solo una vez.

bash
export CLOUD_API_KEY="ak_live_..."

2. Instala el SDK

bash
npm install @enzonic/cloud-api

3. Busca un egg y una región

ts
import { CloudClient } from "@enzonic/cloud-api";
const cloud = new CloudClient({ apiKey: process.env.CLOUD_API_KEY! });

const { eggs } = await cloud.eggs();
const { regions } = await cloud.regions();

console.log(eggs[0]);     // { instanceId, eggId, name, ... }
console.log(regions);     // [{ region: "USA", deployable: true, ... }]

4. Despliega

ts
const server = await cloud.servers.create({
  name: "lobby-smp",
  eggId: eggs[0].eggId,
  instanceId: eggs[0].instanceId, // opcional; se elige automáticamente si se omite
  region: "USA",                   // o null para automático
  ramMb: 2048,
  cpuPercent: 200,
  diskMb: 10240,
});

await cloud.servers.power(server.id, "start");
console.log("Desplegado", server.id);

5. Gestiona el servidor

ts
await cloud.servers.command(server.id, "say Hello from Cloud API");
const usage = await cloud.servers.resources(server.id);
const { data } = await cloud.files.list(server.id, "/") as any;
await cloud.servers.delete(server.id); // cuando termines

Eso es todo el flujo. Consulta Desplegar servidores para el conjunto completo de opciones.