Section
Models

/v1/models

List the models available to your workspace.

GET/v1/models

List every model your API key can call. OpenAI-compatible wire shape — the openai SDKs work with a base_url swap to https://api.tokenfactory.omniva.com/v1.

Use this endpoint for programmatic model discovery. The richer dashboard catalog (capabilities, pricing, benchmarks) is intentionally not on this surface — see the contrast in Models overview.

#Authentication

Bearer token in the Authorization header. See Authentication for how to mint and rotate keys.

HTTP
Authorization: Bearer $OMNIVA_API_KEY

#Request

No request body. No query parameters. The list returned is scoped to the workspace that owns the API key.

#Response

Returns a list object whose data contains one model entry per callable model.

200application/json
{
"object": "list",
"data": [
  {
    "id": "Omniva/glm-5.3",
    "object": "model",
    "created": 0,
    "owned_by": "Omniva"
  }
]
}

#Response fields

  • object — always "list".
  • data[].id — provider-prefixed model identifier. Pass this as model to /v1/chat/completions, /v1/embeddings, and other endpoints.
  • data[].object — always "model".
  • data[].created — Unix timestamp, may be 0 if the model has no provider-published creation date.
  • data[].owned_by — provider or org that owns the model.

This list reflects the shared model catalog. If your workspace has dedicated endpoints, don't rely on this endpoint to discover their Model IDs — copy each one directly from its entry in the console instead; see Call a dedicated endpoint.

#Errors

StatusCodeWhen
401unauthorizedMissing Authorization header or non-Bearer scheme.
401invalid_api_keyBearer token did not resolve to a live API key.
500internal_errorUnexpected gateway failure — retry with backoff.
503upstream_unavailableCatalog backend is unreachable — retry with backoff.

See Errors for the full error envelope and retry guidance.

#Code samples

from openai import OpenAI
import os

client = OpenAI(
  api_key=os.environ["OMNIVA_API_KEY"],
  base_url="https://api.tokenfactory.omniva.com/v1",
)

models = client.models.list()
for m in models.data:
  print(m.id)

#What next

Was this page helpful?