Skip to content

listAiModels

GET
/settings/ai/models
curl --request GET \
  --url http://localhost:8080/api/v1/settings/ai/models \
  --cookie hs_session=<hs_session>

Coming in 1.0. Defined in the contract, not implemented on main yet (task S-17); the server answers 501 with code not_implemented.

Models from OpenRouter’s model list that accept image input and support structured outputs, with OpenRouter’s prices.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
q
string
<= 100 characters

Responses

Section titled “Responses”

200

Section titled “200”

Models.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
name
required
string
inputUsdPerMTok
required
number
outputUsdPerMTok
required
number
contextLength
integer

Examples

Exampleseed

Derived from fixtures/seed.json.

{
  "items": [
    {
      "contextLength": 131072,
      "id": "xiaomi/mimo-v2.6-pro",
      "inputUsdPerMTok": 0.3,
      "name": "MiMo v2.6 Pro",
      "outputUsdPerMTok": 1.2
    }
  ]
}

409

Section titled “409”

Conflicts with current state.

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
code
required
string
i18nKey
string
detail
string
fields
Array<object>
object
path
required
string
code
required
string
i18nKey
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}

502

Section titled “502”

A remote server did not answer.

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
code
required
string
i18nKey
string
detail
string
fields
Array<object>
object
path
required
string
code
required
string
i18nKey
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}