Guide — 01 / Quickstart

Quickstart

LAST UPDATED IN SEPTEMBER 2026

This page submits one job to M1 and reads its telemetry. It takes about 5 minutes once you have an API key.

1. Get a key

Request access. When your invitation arrives, create a key in the console under Settings, then export it.

$COPY
export MELAPS_API_KEY=<your-key>

2. Check capacity

$COPY
curl -s https://api.melaps.system/v1/capacity \
  -H "Authorization: Bearer $MELAPS_API_KEY"

A successful response lists each cluster with free GPUs per plan.

jsonCOPY
{
  "clusters": [
    { "id": "m1", "region": "us-west", "gpu": "h100-sxm-80gb",
      "free": { "on_demand": 2, "batch": 5 }, "reserved_until": null }
  ]
}

3. Submit a job

A job is a container image, a command, a GPU count and a plan.

$COPY
curl -s https://api.melaps.system/v1/jobs \
  -H "Authorization: Bearer $MELAPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cluster": "m1",
    "image": "ghcr.io/yourlab/train:latest",
    "command": ["python", "train.py", "--epochs", "3"],
    "gpus": 2,
    "plan": "on_demand",
    "max_minutes": 240
  }'

The same call in Python, with the standard library only:

pythonCOPY
import json, os, urllib.request
req = urllib.request.Request(
    "https://api.melaps.system/v1/jobs",
    data=json.dumps({
        "cluster": "m1",
        "image": "ghcr.io/yourlab/train:latest",
        "command": ["python", "train.py", "--epochs", "3"],
        "gpus": 2,
        "plan": "on_demand",
        "max_minutes": 240,
    }).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['MELAPS_API_KEY']}",
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(req) as r:
    job = json.load(r)
print(job["id"], job["status"])

4. Read the job

$COPY
curl -s https://api.melaps.system/v1/jobs/job_01j8x2 \
  -H "Authorization: Bearer $MELAPS_API_KEY"

Status moves through queued, running, succeeded or failed. The response includes the GPU ids assigned, start and end timestamps, and metered minutes so far.

5. Read telemetry

$COPY
curl -s "https://api.melaps.system/v1/clusters/m1/telemetry?window=5m" \
  -H "Authorization: Bearer $MELAPS_API_KEY"

You get one sample per second per GPU: utilization in percent, memory used in GB, temperature in C, power in W. The telemetry page describes the schema and the websocket option for streaming.

Next

Read Run a job for image requirements, storage mounts and plans. Read the API reference for every field.