API Reference

Complete reference for the SAPI Gateway REST API.

POST

/v1/chat/completions

Creates a model response for the given chat conversation. Supports streaming via Server-Sent Events.

json

GET

/health

Health check endpoint. Returns service status and uptime.

GET

/api/user/me

Returns current user profile, balance, and status. Requires session authentication.

GET

/api/user/usage

Aggregated usage statistics by day or month. Query params: period, model.

GET

/api/user/ledger

Personal usage ledger entries. Query params: limit, offset.

Error Codes

400

invalid_request_error

Missing required fields or invalid values.

401

authentication_error

Invalid or missing API key / session token.

402

billing_error

Insufficient balance to complete the request.

429

rate_limit_error

Rate limit exceeded (RPM, tokens/day, or concurrent).

500

server_error

Internal gateway or upstream provider error.

Each API key has configurable rate limits: