API Reference
Spice.ai Cloud Platform API Reference
The Spice.ai Cloud Platform exposes two sets of APIs: Runtime APIs for querying data and AI, and the Management API for managing projects and infrastructure.
Runtime APIs
Runtime APIs are served at https://data.spiceai.io and authenticated with Project API keys.
| API | Endpoint | Documentation |
|---|---|---|
| SQL Query (HTTP) | POST /v1/sql | HTTP API |
| SQL Query (Arrow Flight) | grpc+tls://flight.spiceai.io | Arrow Flight API |
| LLM Chat Completions | POST /v1/chat/completions | LLM API |
| Text-to-SQL | POST /v1/nsql | Text-to-SQL API |
| Text-to-SQL context | GET /v1/nsql/context | Text-to-SQL API |
| Search | POST /v1/search | Search API |
| MCP | POST /v1/mcp | MCP API |
| Health | GET /health | Health API |
| Metrics | GET /v1/metrics | Metrics API |
Management API
The Management API is served at https://api.spice.ai and authenticated with Personal Access Tokens or OAuth client credentials.
| Endpoint | Documentation |
|---|---|
| Projects | Projects API |
| Deployments | Deployments API |
| Secrets | Secrets API |
| API Keys | API Keys API |
| Members | Members API |
| Regions | Regions API |
| Container Images | Container Images API |
| Health | Health API |
See the full Management API reference for authentication, scopes, rate limits, and examples.
OpenAPI Specification
The Spice.ai Platform API spec is available at:
https://api.spice.ai/v1/docs/openapi.json