All Endpoints
Complete reference of all Ryvion API endpoints.
Base URL: https://api.ryvion.ai
Authentication: Authorization: Bearer YOUR_API_KEY or X-API-Key: YOUR_API_KEY
Inference gateway
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/models | List available models |
POST | /v1/chat/completions | Chat inference (streaming + non-streaming) |
POST | /v1/embeddings | Generate text embeddings |
POST | /v1/images/generations | Generate images (SDXL Turbo / SDXL) |
POST | /v1/audio/transcriptions | Transcribe audio (Whisper) |
Knowledge base
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/knowledge-bases | Create a knowledge base |
GET | /api/v1/knowledge-bases | List your knowledge bases |
POST | /api/v1/knowledge-bases/:id/documents | Upload a document for embedding |
POST | /api/v1/knowledge-bases/:id/search | Semantic search over your documents |
GET | /api/v1/knowledge-bases/:id/graph | Query the knowledge graph |
Agent memory
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/knowledge-bases/:id/agents | Register an agent session |
POST | /api/v1/knowledge-bases/:id/agents/:name/memories | Store an agent memory |
GET | /api/v1/knowledge-bases/:id/agents/:name/memories | List agent memories |
DELETE | /api/v1/knowledge-bases/:id/agents/:name/memories/:key | Delete a specific memory |
GET | /api/v1/knowledge-bases/:id/agents/:name/diary | Read agent diary |
Agent hosting
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/agents/deploy | Deploy an agent |
GET | /api/v1/agents/deployments | List deployments |
POST | /api/v1/agents/deployments/:id/stop | Stop a running agent |
Account and billing
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/auth/me | Current user profile |
GET | /api/v1/auth/api-keys | List API keys |
POST | /api/v1/auth/api-keys | Create an API key |
GET | /api/v1/billing/balance | Check credit balance |
POST | /api/v1/billing/purchase-credits | Purchase credits |
Network and health
| Method | Endpoint | Description |
|---|---|---|
GET | /healthz | Health check |
GET | /ready | Readiness check |
GET | /api/v1/network/stats | Network statistics |
GET | /api/v1/marketplace/nodes | List active nodes |
MCP
| Method | Endpoint | Description |
|---|---|---|
| -- | /mcp | MCP protocol endpoint (SSE transport) |