List the models an assistant can use
List the models this deployment can actually reach, which is what an assistant may use. With no provider configured it can neither answer nor ingest.
GET
/
models
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/models" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/models",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/models`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"data": [
{
"id": "anthropic/claude-sonnet-5",
"provider": "anthropic",
"name": "claude-sonnet-5",
"capabilities": ["chat", "streaming"],
"context_window": 1000000,
"max_output_tokens": 128000
},
{
"id": "openai/text-embedding-3-small",
"provider": "openai",
"name": "text-embedding-3-small",
"capabilities": ["embedding"],
"context_window": null,
"max_output_tokens": null
}
]
}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
The list contains the catalogued chat models of every provider this deployment can reach. A provider the deployment has no credential for contributes no models, so a deployment with no provider configured returns an empty
data array rather than an error.
Each model’s id is exactly the string you put in an assistant’s model field. See Configure an assistant. Embedding models are not listed, because an assistant cannot answer with one: saving an assistant with a catalogued embedding model is refused with 400.
The response is not paginated. It requires a role that can read assistants, which every role except dataset_operator has.
Response
object[]
required
The models, in catalogue order.
Show properties
Show properties
string
The qualified selector,
provider/name. Use this as an assistant’s model.string
The provider:
anthropic, openai or google.string
The model name within its provider.
string[]
What the model supports, sorted alphabetically. Values:
chat, embedding, rerank,
streaming.integer | null
Input tokens the model accepts, when known.
integer | null
Output tokens the model can produce, when known.
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/models" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/models",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/models`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"data": [
{
"id": "anthropic/claude-sonnet-5",
"provider": "anthropic",
"name": "claude-sonnet-5",
"capabilities": ["chat", "streaming"],
"context_window": 1000000,
"max_output_tokens": 128000
},
{
"id": "openai/text-embedding-3-small",
"provider": "openai",
"name": "text-embedding-3-small",
"capabilities": ["embedding"],
"context_window": null,
"max_output_tokens": null
}
]
}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/models" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/models",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/models`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"data": [
{
"id": "anthropic/claude-sonnet-5",
"provider": "anthropic",
"name": "claude-sonnet-5",
"capabilities": ["chat", "streaming"],
"context_window": 1000000,
"max_output_tokens": 128000
},
{
"id": "openai/text-embedding-3-small",
"provider": "openai",
"name": "text-embedding-3-small",
"capabilities": ["embedding"],
"context_window": null,
"max_output_tokens": null
}
]
}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }