Infinite Context SDK Documentation
Developer Preview • Base URL: https://icx.api.caleralabs.com/v1 • OpenAPI Spec (JSON)
1. Overview & Architecture
The Infinite Context SDK (ICX) acts as an OpenAI protocol-compatible proxy that delegates attention and associative document recall to the Volumetric Lattice Network. By using sub-quadratic memory crystallization, ICX enables multi-million token context recall with zero statistical degradation.
Trust Boundary: All facts, tokens, and associations are stored directly in the Volumetric Lattice Network memory space. Optional third-party LLMs (BYOK) act solely as external generation interfaces and never modify Calera lattice state.
2. Authentication & API Key Format
Authenticate requests using standard HTTP Bearer token authorization with an ICX domain API key generated from your Calera Labs Dashboard:
Authorization: Bearer icx_live_your_api_key_here
Keys use the icx_live_ prefix for production endpoints and icx_test_ for test environments.
3. OpenAI SDK Drop-In Integration
Simply override baseURL="https://icx.api.caleralabs.com/v1" when initializing your standard openai SDK client package:
Python
from openai import OpenAI client = OpenAI( base_url="https://icx.api.caleralabs.com/v1", api_key="icx_live_your_api_key" ) completion = client.chat.completions.create( model="icx-v1", messages=[ {"role": "system", "content": "You access associative memory on the Volumetric Lattice Network."}, {"role": "user", "content": "Recall exact contractual indemnity cap across all enterprise MSAs."} ] ) print(completion.choices[0].message.content)
Node.js / TypeScript
import OpenAI from 'openai'; const openai = new OpenAI({ baseURL: 'https://icx.api.caleralabs.com/v1', apiKey: 'icx_live_your_api_key' });
cURL
curl -X POST https://icx.api.caleralabs.com/v1/chat/completions \
-H "Authorization: Bearer icx_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"model": "icx-v1", "messages": [{"role": "user", "content": "Query memory"}]}'
4. Rate Limits & Quotas
| Tier | Active Token Quota | Burst Limit (RPM) | Memory Spaces |
|---|---|---|---|
| Developer | 50,000 active tokens | 30 RPM | 1 Space |
| Team | 5,000,000 active tokens | 150 RPM | 10 Spaces |
| Enterprise | Dedicated High Capacity | 1,500 RPM | Unlimited |
5. Memory Space Lifecycle API
Manage isolated memory spaces directly via REST endpoints:
- POST /v1/memory/spaces — Create a new isolated memory space
- GET /v1/memory/spaces — List active memory spaces for tenant
- DELETE /v1/memory/spaces/{space_id} — Flush and remove memory space
6. Error Codes Catalog
401 Unauthorized— Invalid or expired ICX API key.429 Rate Limit Exceeded— Request rate exceeded tier burst limit.503 Service Unavailable— Volumetric Lattice Network node undergoing maintenance.LATTICE_REFUSAL_FACT_NOT_FOUND— Fact not present in memory space; system refused to hallucinate.