TRC Developer API v1 — Unified AI Model Gateway, Media, Voice & Storage Reference

Authentication, 12 Granular Scopes & Wallet Guardrails

Pass your API key in either Authorization: Bearer trc_... or x-trc-api-key: trc_.... Keys are displayed once at creation, stored as irreversible SHA-256 hashes, isolated per client installation (rotating or signing into one device never invalidates another device key), and rate-limited at 120 req/min per key.

Deterministic Billing Order & Fee Transparency: Every billable call draws from your included monthly plan compute allowance first, then from your pre-funded TRC Wallet balance (which carries a transparent 10% gateway settlement fee over provider base rates; Bring-Your-Own-Key routing carries $0.00 / 0% markup). If balance reaches zero, the gateway returns a clean, structured HTTP 402 Payment Required JSON payload (code: "INSUFFICIENT_FUNDS") rather than incurring surprise post-paid overages.

Multi-Provider AI Gateway & Verified Token Economics

Route standard OpenAI Chat Completions payloads to POST /api/v1/ai/:provider/chat/completions where :provider is deepseek, google, openai, anthropic, alibaba, kimi, xai, or together. Native Claude tool-use and thinking blocks are also supported directly at POST /api/v1/ai/anthropic/messages.

Automatic Off-Peak & Prefix-Cache Savings: DeepSeek V4.1 peak hours are strictly 01:00–04:00 UTC and 06:00–10:00 UTC Monday–Friday (35 hours/week). During the remaining 133 of 168 hours each week (79% of the week, including all weekend hours), TRC automatically applies 50% off-peak pricing plus prefix-cache discounts with zero configuration required. Query GET /api/v1/pricing (no API key required) at any moment for the live machine-readable rate card.

Core /api/v1 Endpoint Reference

Public discovery endpoints (/api/v1/pricing and /api/v1/models) require no authentication; billable and account endpoints accept Bearer trc_... over HTTPS at https://api.trc.inc/api/v1. Machine-readable schemas are published at https://www.trc.inc/openapi.json.

Anthropic SDK (Native)

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: process.env.TRC_API_KEY, // Bearer trc_...
  baseURL: 'https://api.trc.inc/api/v1/ai/anthropic',
});

const message = await anthropic.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Review this SQL migration for lock contention.' }],
});

console.log(message.content);

Game Sprite Tileset + Whisper (cURL)

# 1. Generate a chroma-key sliced 4x4 2D game sprite sheet
curl -X POST "https://api.trc.inc/api/v1/ai/images/tileset" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "isometric stone dungeon floor tiles, crisp pixel art",
    "columns": 4,
    "rows": 4
  }'

# 2. Transcribe a recorded meeting or voice memo with TRC Whisper
curl -X POST "https://api.trc.inc/api/v1/transcribe" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -F "file=@./standup-note.m4a"

Frequently Asked Questions

How does Bring-Your-Own-Key (BYOK) work alongside the TRC Wallet?

You can attach your own OpenAI, Anthropic, Google, DeepSeek, Alibaba, Kimi, or xAI provider keys in account settings or VS Code SecretStorage. TRC charges $0.00 markup on BYOK requests while still letting you use TRC Storage Vault, Studios, and fallback Wallet models.