GET /v1/models
- Updated
- Reading time
- 1 min
Lists the models currently enabled on Revoye Cloud, in OpenAI's list shape, so a model picker written against an OpenAI SDK works without modification.
curl $REVOYE_BASE_URL/v1/models \
-H "Authorization: Bearer $REVOYE_API_KEY"{
"object": "list",
"data": [
{ "id": "revoye/auto", "object": "model", "created": 1756944000, "owned_by": "revoye" },
{ "id": "chatgpt", "object": "model", "created": 1756944000, "owned_by": "revoye" },
{ "id": "claude", "object": "model", "created": 1756944000, "owned_by": "revoye" },
{ "id": "deepseek", "object": "model", "created": 1756944000, "owned_by": "revoye" }
],
"_revoye": { "user_id": "usr_01JAY7…" }
}- Each
idis a value you can send asmodelto/v1/chat/completions, or asproviderto/v1/completions(revoye/autothere is simply omittingprovider). revoye/autoheads the list whenever at least one model is enabled. It means "whichever model can answer first".- Disabled models are omitted. When none is enabled,
datais empty and_revoye.notesays so, which is how you tell an empty list from a broken endpoint. - The list reflects what is enabled, not what is free right now. A model can appear here while all
of its capacity is busy —
/v1/statusis the endpoint that knows.
Requires status:read.