RunarsRunars Docs
EndpointsAPI Endpoints

GET /v1/models

List available models

List available models. Runars serves a catalog of models—this endpoint returns the ones your organization can access. It also provides compatibility with OpenAI SDK's .models.list() method.

Endpoint

GET https://runars.ca/v1/models

Authentication

Include your API key as a Bearer token:

-H "Authorization: Bearer sk-runars-..."

Note: Unlike some OpenAI APIs, this endpoint requires authentication. Invalid or missing keys return 401 Unauthorized.

Response

{
  "object": "list",
  "data": [
    {
      "id": "glm-5.3-flash",
      "object": "model",
      "owned_by": "runars",
      "permission": []
    }
  ]
}

The response includes one entry per enabled model in your catalog. Requesting a model id that isn't in this list returns 404 model_not_found—unknown ids are never silently substituted.

Examples

Using curl

curl https://runars.ca/v1/models \
  -H "Authorization: Bearer sk-runars-..."

Using the OpenAI SDK

import OpenAI from "openai"

const openai = new OpenAI({
  baseURL: "https://runars.ca/v1",
  apiKey: process.env.OPENAI_API_KEY,
})

const models = await openai.models.list()
console.log(models.data)

Output:

[
  {
    id: 'glm-5.3-flash',
    object: 'model',
    owned_by: 'runars',
    permission: []
  }
]

Programmatically checking model availability

const models = await openai.models.list()
const runarsAvailable = models.data.some((m) => m.id === "glm-5.3-flash")
console.log(`GLM-5.3 Flash available: ${runarsAvailable}`)

Error responses

401 Unauthorized

Invalid or missing API key:

{
  "error": {
    "message": "Unauthorized",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

404 model_not_found

Returned by /v1/messages, /v1/chat/completions, and /v1/responses when the requested model id isn't in the catalog. Requesting an unknown model never substitutes a default—the caller must send a valid id from GET /v1/models.

Model details

The default glm-5.3-flash model is:

  • 1,048,576-token context window (~1M tokens)
  • Served from our Canadian GPU Cloud in Montreal & Calgary (Canadian data residency)
  • Pricing: $0.21/1M input tokens, $0.70/1M output tokens (see Pricing or browse all Models)

The catalog also includes larger models (e.g. glm-5.3) with their own context windows and pricing—GET /v1/models and the Models page always reflect the current set. For more information, see the Overview.

On this page