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

Customers

  • GET /api/v1/customers - List customers
  • POST /api/v1/customers - Create a customer
  • GET /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