API Reference
The ModelRelay API is organized around REST. Our API accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.
Base URL
https://api.modelrelay.ai/api/v1
Authentication
All API requests require authentication via API key:
curl https://api.modelrelay.ai/api/v1/responses \
-H "Authorization: Bearer mr_sk_..."
Endpoints
Responses
POST /api/v1/responses- Create a response
Models
GET /api/v1/models- List available models
Customers
GET /api/v1/customers- List customersPOST /api/v1/customers- Create a customerGET /api/v1/customers/:id- Get a customer
Auth
POST /api/v1/auth/customer-token- Create a customer token
Rate Limits
| Key Type | Requests/min |
|---|---|
| Secret | 1000 |
| Publishable | 100 |
| Customer Token | Tier-defined |
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 429 | Rate Limited |
| 500 | Internal Error |