GET /v1/models

Lists the models your plan can use, in OpenAI's list shape, so a model picker written against an OpenAI SDK works without modification.

curl https://api.revoye.com/v1/models \
  -H "Authorization: Bearer $REVOYE_KEY"

{
  "object": "list",
  "data": [
    { "id": "revoye/auto", "object": "model", "created": 1760346842, "owned_by": "revoye" }
  ],
  "_revoye": { "user_id": "usr_01JAY7…" }
}

data continues with one entry per model your plan can use.

• revoye/auto heads the list whenever at least one model is available to you. It means "let Revoye choose", and it is the recommended value for model on /v1/chat/completions.
• Every other id is a value you can send as model there, or as provider on /v1/completions.
• The list covers the channels your plan includes — Revoye Cloud, Revoye Desk, or both. A model that is switched off is left out rather than listed as unavailable.
• An empty data comes with _revoye.note, which says why — for example, no active plan.
• The list reflects your plan and settings, not this moment's capacity. /v1/status is the endpoint that knows whether a request can be processed now.

Requires status:read.