API
Model catalog API
Find models by capabilities, context and exact public identifier.
Last updated on
Read the current catalog instead of embedding a historical model list in your code. Generation requests require the exact id, not the human-readable name.
export API_BASE="https://api.provod.ai"
export AI_API_KEY="sk_..."
curl --fail-with-body --silent --show-error \
"$API_BASE/v1/models?output_modalities=text&supported_parameters=max_tokens&limit=20&offset=0" \
-H "Authorization: Bearer $AI_API_KEY"Set API_BASE to your API origin without /v1. The response contains a data array. Check availability and supported request formats on the selected entry. A catalog entry does not guarantee live capacity at request time.
| Parameter | Purpose |
|---|---|
q | Search |
context | Context |
input_modalities, output_modalities | Input and output modalities |
model_authors | Model authors |
supported_parameters | Supported parameters |
sort | newest, context-high-to-low, pricing-high-to-low, pricing-low-to-high |
limit, offset | Page size 1–1000 and offset |
GET /v1/models/count returns the count for the supplied filters. GET /v1/model/{author}/{slug} returns a model card. GET /v1/models/{author}/{slug}/endpoints describes its endpoints. URL-encode query values rather than interpolating user input manually.
Choosing a model · First request