List models

GET /v1/models returns every chat model in the standard OpenAI list shape ({"object":"list","data":[...]}) plus Hormouz extras such as pricing, context length, and capabilities. OpenAI-compatible tools (IDE assistants included) discover the catalogue through this endpoint. Image, video, and audio models are called through predictions, and the public models pages list all of them.

GET/v1/modelsBearer auth

List available models

Returns the model catalogue in the OpenAI-standard list shape ({"object":"list","data":[…]}), so OpenAI-compatible clients and IDE tools (Cursor, VSCode Copilot, Zed) can discover models.

The response is unpaginated: clients fetch the list once.

Every model callable through an OpenAI-standard endpoint is listed, and each entry carries an api_shape telling you which endpoint that is:

`api_shape`	Endpoint
`chat_completions`	`POST /v1/chat/completions`
`embeddings`	`POST /v1/embeddings`
`speech`	`POST /v1/audio/speech`
`transcriptions`	`POST /v1/audio/transcriptions`

Chat models are listed first, so a model picker that renders this list in order opens on them.

Image and video models are not listed: they are served by POST /v1/predictions, which is not an OpenAI-standard endpoint, so no OpenAI-compatible client can call them. Browse those on the models page of your Hormouz dashboard.

Parameters

Field	in	Type	Description
`api_shape`	query	string	Return only models of one shape. Omit to get everything. Useful when a client validates a configured model against this list. For example, an embeddings integration can request `?api_shape=embeddings`. An unrecognised value is a `400`, never an empty list, so a typo cannot look like "this account has no such models".

Example

curlPythonJavaScriptGo

curl https://api.hormouz.net/v1/models \
  -H "Authorization: Bearer ng-YOUR_API_KEY"

from openai import OpenAI

client = OpenAI(api_key="ng-YOUR_API_KEY", base_url="https://api.hormouz.net/v1")

for model in client.models.list():
    print(model.id)

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "ng-YOUR_API_KEY", baseURL: "https://api.hormouz.net/v1" });

const models = await client.models.list();
for (const model of models.data) console.log(model.id);

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.hormouz.net/v1/models", nil)
	req.Header.Set("Authorization", "Bearer ng-YOUR_API_KEY")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var out struct {
		Data []struct {
			ID string `json:"id"`
		} `json:"data"`
	}
	json.NewDecoder(resp.Body).Decode(&out)
	for _, m := range out.Data {
		fmt.Println(m.ID)
	}
}

Responses

200

OpenAI-standard list of models.

400

The api_shape value is not one of the four listed shapes.

401

Authentication failed. Either the Authorization header is missing, the key format is invalid, or the key doesn't match any active account.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required",
    "status": 401
  }
}

429

Too many requests. Back off and retry after a short delay. Check the Retry-After header for guidance.