فهرست مدل‌ها

GET /v1/models فهرست تمام مدل‌های چت را در قالب استاندارد OpenAI برمی‌گرداند ({"object":"list","data":[...]}). به‌همراه فیلدهای اضافهٔ هرمز مثل قیمت، طول کانتکست و قابلیت‌ها. ابزارهای سازگار با OpenAI (مثل IDE‌ها) با همین اندپوینت کاتالوگ را کشف می‌کنند. مدل‌های تصویر، ویدیو و صدا از طریق predictions فراخوانی می‌شوند و صفحهٔ عمومی مدل‌ها همهٔ آن‌ها را نمایش می‌دهد.

GET/v1/modelsاحراز هویت Bearer

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.

پارامترها

فیلد	in	نوع	توضیح
`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".

نمونه

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)
	}
}

پاسخ‌ها

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.