API Playground /0.3

API Playground.

Explore HarchOS APIs interactively. Build requests, inspect responses, and generate production-ready code in any language.

API Groups

Endpoints

Request Headers

Request Body

{

"gpu_type": "H100",

"count": 8,

"region": "morocco-dakhla",

"sovereignty": "strict",

"carbon_aware": true,

"image": "pytorch/2.2.0-cuda12.1"

}

200 OK 12ms1.2 KB

{
  "id": "d-7f3a2b1c4e5f",
  "status": "running",
  "created_at": "2025-03-15T14:32:00Z",
  "hub": {
    "name": "harch-alpha",
    "location": "Dakhla, Morocco",
    "energy_source": "offshore wind"
  },
  "gpu": {
    "type": "H100",
    "count": 8,
    "utilization": 0.87,
    "memory_used_gb": 640,
    "memory_total_gb": 800
  },
  "networking": {
    "endpoint": "https://mesh.harchos.com/d-7f3a2b1c4e5f",
    "latency_ms": 12,
    "bandwidth_gbps": 100
  },
  "sustainability": {
    "carbon_score": "A+",
    "renewable_percentage": 100,
    "co2_saved_kg": 127.4
  }
}

Authentication

All HarchOS API requests require a valid API key passed via the Authorization header. API keys start with harch_sk_ and can be generated from your developer dashboard.

Authorization: Bearer harch_sk_your_api_key_here

Never expose your API key in client-side code. Use environment variables or a server-side proxy in production.

Code Generation

curl -X POST https://api.harchos.com/v1/compute/deploy \
  -H "Authorization: Bearer harch_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "gpu_type": "H100",
    "count": 8,
    "region": "morocco-dakhla",
    "sovereignty": "strict",
    "carbon_aware": true,
    "image": "pytorch/2.2.0-cuda12.1"
  }'

Rate Limits

Starter

Rate Limit100 req/min

Burst200

Professional

Rate Limit1,000 req/min

Burst2,000

Enterprise

Rate Limit10,000 req/min

BurstCustom

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset