Models and permissions

---
title: Models and permissions
description: Use exact model IDs and understand per-key limits.
lastUpdated: 2026-07-29
---

The public [models.json](https://docs.relyven.com/models.json) synchronizes model IDs, providers, endpoint capabilities, billing types, and pricing versions from the anonymous catalog every five minutes. `stale: true` means the latest successful cache or the repository 18-model fallback is being served.

Tags in `models.json` are stable English capability identifiers even when the model catalog UI is Chinese. Verified Relyven compatibility capabilities can add an endpoint such as Seedream `/v1/images/edits`; they do not add or remove a model ID from the 12-model source set.

Call `GET https://api.relyven.com/v1/models` with your key to list models it can actually use. The public catalog is for discovery; the authenticated list is authoritative for integration.

Keys can be restricted by model and group. Relyven does not silently downgrade an unavailable model to a weaker one.

The public models.json synchronizes model IDs, providers, endpoint capabilities, billing types, and pricing versions from the anonymous catalog every five minutes. stale: true means the latest successful cache or the repository 18-model fallback is being served.

Tags in models.json are stable English capability identifiers even when the model catalog UI is Chinese. Verified Relyven compatibility capabilities can add an endpoint such as Seedream /v1/images/edits; they do not add or remove a model ID from the 12-model source set.

Call GET https://api.relyven.com/v1/models with your key to list models it can actually use. The public catalog is for discovery; the authenticated list is authoritative for integration.

Keys can be restricted by model and group. Relyven does not silently downgrade an unavailable model to a weaker one.