API Reference
Base URL: https://api.surplusintelligence.ai/v1
Authentication
No auth header → returns HTTP 402 with payment requirements for both x402 and MPP.
The dashboard is a pure client of this API. Everything you can do in the web app, you can do here: managing keys, providers, offers, pricing, balances, savings, earnings, and payouts are all HTTP calls, no browser required. Most of it works with your API key (inf_… for buyers, si_seller_… for sellers); a few organization, treasury, and admin surfaces are session or management-key gated. See the buyer and seller reference pages below.
Inference (OpenAI-compatible)
Also available:
POST /v1/embeddings— text embeddingsPOST /v1/audio/speech— text-to-speechPOST /v1/audio/transcriptions— speech-to-text (Whisper)GET /v1/media/artifacts/:jobId/:index— download media artifact (proxy fallback)GET /v1/providers: the curated provider allowlist, with each provider's host andtrustedflag (live JSON)
Capability Lookups
Three capabilities vary by model and must be looked up rather than assumed.
- Media input (images, video, documents, audio sent to a model): Media Inputs. A separate surface from image/video generation.
- Reasoning effort, including request shapes and marketplace adaptations: Reasoning Controls.
- Provider identity and what is verified about it: Provider & Model Verification.
Minimum-discount routing
Insert an optional min{N} segment (e.g. /min30/v1/chat/completions) to require marketplace seller offers to meet a minimum estimated buyer discount (min0–min100, no leading zeros) before routing. No qualifying seller returns 503 minimum_discount_not_met. The threshold applies to SI marketplace seller offers only — buyer-owned priority/fallback providers are not covered. Embeddings and MPP/dual-402 min-discount are out of scope in v1. See Minimum-Discount Routing.
Tool calling and Anthropic sellers: Buyers always send OpenAI-format requests. For OpenAI-compatible sellers such as Venice, Bankr, OpenRouter, Together, Fireworks, Groq, Mistral, and DeepSeek, tool support depends on the upstream model and is advertised in GET /v1/models via supported_parameters. For native Anthropic sellers (api.anthropic.com), the router has OpenAI ⇄ Anthropic translation for text, vision, streaming, tool calls, assistant tool_calls, and role: "tool" result messages. That translation is implemented and covered by tests, but there are currently no active native Anthropic seller offers in production; Claude traffic is primarily served through OpenAI-compatible providers. Non-function computer/text-editor style tools are stripped, and models that do not advertise tool support have tools/tool_choice removed before forwarding.
Market Data (public, no auth)
Buyer Management
Seller Management
CORS
All /v1/* inference endpoints include CORS headers for browser-based clients. Preflight OPTIONS requests are handled automatically.