1. Quickstart Guide
Elvio Labs APIs are strictly wire-compatible with standard OpenAI library formats. If your codebase already uses the OpenAI Python or TypeScript SDK, you only need to adjust the base_url.
# Python SDK
pip install elvio-labs-sdk
# Node.js / TypeScript
npm install @elviolabs/sdk
2. Authentication
All requests to https://api.elviolabs.com/v1 require a Bearer token in the HTTP Authorization header:
HTTP Header Format
Authorization: Bearer elvio_live_sk_948fbc21890e447b1928
3. Official Client SDK Examples
curl -X POST https://api.elviolabs.com/v1/chat/completions \
-H "Authorization: Bearer $ELVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elvio-neural-mesh-3",
"messages": [{"role": "user", "content": "Analyze portfolio risk matrix"}],
"cache": "semantic-l1",
"stream": true
}'
4. Core API Endpoints
POST
Chat & LLM inference execution
/v1/chat/completions
POST
Autonomous multi-agent coordinator
/v1/agents/swarm/dispatch
POST
VectorFlow high-dimensional indexing
/v1/vectors/upsert
POST
CloudGuard zero-trust security filter
/v1/guard/inspect
5. Standard HTTP Status & Error Codes
| Status Code | Meaning | Resolution |
|---|---|---|
| 200 OK | Successful request execution | Stream or JSON body returned. |
| 401 Unauthorized | Invalid or expired API token | Verify `Authorization: Bearer` key in Elvio dashboard. |
| 429 Rate Limit | Exceeded requests per minute | Implement exponential backoff or upgrade to Scale plan. |
| 503 Degraded | Upstream cloud fallback triggered | Mesh auto-recovers to secondary edge region in < 20ms. |