Skip to main content

​
Base URLs

The Relace API is organized into two base URLs: models.relace.ai for direct AI model access, and api.relace.run for general infrastructure services including source control.

​
Model Endpoints

All hosted models are served from this base url — the route determines which model you are using. e.g. /v1/code/apply, /v2/code/rank, /v1/code/compact, /v1/search/chat/completions.

​
Infrastructure Endpoints

For accessing our infrastructure (e.g. source control) you will use the routes specified in this API reference with our common base url.

​
Authentication

To authenticate you need to add an Authorization header with the contents of the header being your Relace API Key, which is a 32 digit key with the prefix rlc-.

​
Response Codes

Relace uses standard HTTP codes to indicate the success or failure of your requests. In general, 2xx HTTP codes correspond to success, 4xx codes are for user-related failures, and 5xx codes are for infrastructure issues. Check Errors for the response bodies, the canonical messages, and retry guidance.

​
Rate Limits

Rate limits are a per-key request budget over a rolling 60 second window. Free accounts start at 15 requests per minute, and the budget scales with your account tier up to unlimited for high-volume users. When you exceed your rate limit, you’ll receive a 429 response with a Retry-After header. To raise your limits, contact support.