Skip to content

HTTP API

List models

GET
/v1/models
curl --request GET \
--url https://sergo.example.com/v1/models \
--header 'Authorization: Bearer <token>'

The language models that presets can use, with their prices and the tokens per page they are expected to use. Send an id as model_id when you upload a file a model reads. Personal keys only.

Successful Response

Media typeapplication/json
AiModelList
object
items
required
Items
Array<object>
AiModel
object
id
required
Id

What to send as model_id

string
name
required
Name
string
provider
required
Ref
object
id
required
Id
string
name
required
Name

Its name, or null if it was deleted

Any of:
string
external
required
External

Pages are sent to a provider outside this install

boolean
vision
required
Vision

It can read page pictures

boolean
input_price
required
Input Price

Credits per million input tokens

number
output_price
required
Output Price

Credits per million output tokens

number
estimates
required
Estimates

Tokens per page it is expected to use, for each processor that calls a model

Array<object>
ModelEstimate
object
processor_id
required
Processor Id
string
input_tokens_per_page
required
Input Tokens Per Page
integer
output_tokens_per_page
required
Output Tokens Per Page
integer
source
required
Source

observed: the average of pages read lately. manual: set by an admin. default: the processor’s default

string
default: none
Allowed values: observed manual default none
sample_count
required
Sample Count

Pages read so far that the average could use

integer
0
default_id
required
Default Id

The model an admin made the default

Any of:
string
last_used_id
required
Last Used Id

The model this person used last

Any of:
string

Example

{
"items": [
{
"estimates": [
{
"source": "observed",
"sample_count": 0
}
]
}
]
}