Cloud, Vault & APIs · 50 GB Free to 50 TB · Full AI Markdown Manual (llms-full.txt) · OpenAPI 3.1 Spec

TRC Cloud Storage Vault — Web Drive & Programmatic S3/B2 Object API

Every TRC membership includes persistent encrypted cloud storage — starting at 50 GB on Free and scaling to 50 TB — accessible through both the Web Cloud Explorer and the streaming /api/v1/storage REST API.

  • Free Quota: 50 GB — Included at $0/mo with full REST API access
  • Paid Tiers: 2 TB – 50 TB — Basic 2 TB ($15) · Pro 5 TB ($50) · Ultimate 10 TB ($200)
  • Max Single Upload: 2 GB Stream — Raw binary stream or multipart via /api/v1/storage/upload
  • Required Scopes: storage:read / write — Granular per-key read-only or read-write access

Unified Quota Across Web, Desktop, Mobile & REST API

Unlike consumer cloud drives that lock automation behind enterprise plans or object stores that lack a human-friendly UI, your TRC Cloud Storage Vault is one unified quota shared across /cloud?section=storage, TRC Singularity Desktop, TRC Mobile, and /api/v1/storage.

Zero Object Egress Fees: Stored Cloud Storage Vault objects carry $0.00 per-GB egress fees when downloaded or served via signed URLs (distinct from Sovereign Cloud compute enclaves, which include 1 TB to 20 TB/mo of container network transfer per tier).

Included Cloud Storage Vault Quotas by Plan
PlanMonthly PriceIncluded Vault QuotaProgrammatic /api/v1/storage Access
Free$0 / mo50 GBIncluded (storage:read, storage:write)
Basic$15 / mo (7-day free trial)2 TBIncluded + 2B Frontier Flash AI pool
Pro$50 / mo (7-day free trial)5 TBIncluded + 6.5B Heavy Agent AI pool
Ultimate$200 / mo10 TBIncluded + 26B Priority Agent AI pool
Expansion PacksAdd-on packsUp to 50 TBInstant quota ceiling expansion on B2 object storage

Streaming Uploads, Prefix Listing & Quota Telemetry

Mint an API key in /developer/api with storage:read (for listing and signed URL retrieval) and storage:write (for binary streaming uploads). Binary streams up to 2 GB per request are piped directly through to durable Backblaze B2 object storage without buffering the entire file in memory.

cURL

# 1. Inspect live storage usage and plan ceiling
curl -sS "https://api.trc.inc/api/v1/storage/usage" \
  -H "Authorization: Bearer trc_live_your_scoped_key"

# 2. Stream a large archive or ML checkpoint (up to 2 GB per call)
curl -X POST "https://api.trc.inc/api/v1/storage/upload?folder=backups/nightly" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -H "Content-Type: application/gzip" \
  -H "x-file-name: postgres-backup-2026-11-05.sql.gz" \
  --data-binary "@./postgres-backup-2026-11-05.sql.gz"

# 3. List stored objects and signed retrieval URLs in a folder
curl -sS "https://api.trc.inc/api/v1/storage/files?folder=backups/nightly&limit=50" \
  -H "Authorization: Bearer trc_live_your_scoped_key"

Node.js / TypeScript

import { createReadStream, statSync } from 'node:fs';

const filePath = './dataset-shard-001.tar';
const stat = statSync(filePath);

const res = await fetch('https://api.trc.inc/api/v1/storage/upload?folder=datasets/shards', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TRC_API_KEY}`,
    'Content-Type': 'application/x-tar',
    'Content-Length': String(stat.size),
    'x-file-name': 'dataset-shard-001.tar',
  },
  body: createReadStream(filePath),
  // @ts-expect-error Node 20+ undici streaming body flag
  duplex: 'half',
});

if (!res.ok) throw new Error(`Upload failed: ${res.status}`);
const uploaded = await res.json();
console.log('Stored key:', uploaded);

Frequently Asked Questions

Can I mint a read-only key so CI runners can pull artifacts without write access?

Yes. Select only storage:read when creating the key in /developer/api. Any POST /api/v1/storage/upload attempt with that key is rejected with HTTP 403.