SandBase Docs
Build with Models and APIs directly, or define reusable Agents that run on managed infrastructure.
SandBase provides two complementary ways to build AI applications. Start with the smallest surface that fits the work; you can combine them as the application grows.
Choose how to build
| Models and APIs | Managed Agents | |
|---|---|---|
| What it is | Direct access to language, image, video, audio, and third-party APIs | Reusable, versioned Agent configurations executed by SandBase |
| Best for | Custom application loops and fine-grained request control | Multi-step, asynchronous, or repeatable work |
| You manage | Prompts, orchestration, retries, and application state | Agent definition, enabled capabilities, inputs, and delivery behavior |
| Start here | Models and APIs | Build Agent |
One SandBase API key
The same API key can call Models, APIs, and Agents. Keep keys on the server and never expose them in browser code.
Core concepts
Models and APIs
Use Models for language, image, video, and audio workloads. Use APIs when the application needs external data or actions. The catalog on the SandBase website shows available capabilities, pricing, input schemas, and working examples.
Agents
An Agent is a reusable, versioned configuration containing a Model, instructions, Skills, and MCP connections. Define it once, then run it in Sessions.
Sessions
A Session runs one Agent version. Create it with POST /v1/agents/sessions, send input, stream events, and read the full conversation afterwards.
First steps
- Create an organization and API key.
- Choose a Model, API, or Agent from the catalog.
- Make a direct request or define and test an Agent.
- Run the tested Agent in Sessions from your application.
- Review Sessions, errors, latency, and cost in the Console.
Operational guidance
- Streaming responses
- Error handling and retries
- Rate limiting
- Billing and pricing
- Workspace administration
Next steps
Creating with local Skills: Skill tutorials
New to SandBase: Getting started
Calling a Model or API: Models catalog and APIs catalog
Inference and Agent APIs: API Reference
Building reusable work: Build Agent
Connecting an AI tool: Setup