Inference Providers
An inference provider serves model requests. It can serve models trained by many developers. The public directory includes reviewed platforms with indexed offerings, ordered by indexed model count. Zero-offering providers are excluded from the directory.
The Web model library, organization directories and their model catalogs display 18 entries per page. API consumers can request their own page size with limit and use offset to paginate.
Use the canonical catalog endpoint for fused model cards. The source-native models endpoint retains the provider’s original identifiers and metadata, including deployment versions. These two representations answer different questions and must not be counted as interchangeable models.
Cheaper Inference (cheaperInference) is an inference gateway, separate from
the model creator. Its local collector uses the documented, keyless
https://api.cheaperinference.com/public/models catalog on a 15-minute cadence.
The native cached response keeps the upstream models wrapper. This public
catalog does not establish coverage of authenticated marketplace-only models.
Metadata is retained across supported modalities; the initial price adapter
publishes only validated, single-tier standard text offerings. Ambiguous tiers,
unknown units and unavailable entries retain metadata without comparable prices.
Service status comes from official structured status feeds. It describes reported service/component state and observation freshness; it is not a measured per-model uptime guarantee. Status history is a seven-day record of checks and reports. Original status evidence is retrieved by its recorded checksum.
Collected organization introductions are available as nullable profile objects.
They include summary, paragraph-separated plain-text description, homepage,
links, source_url, source_kind, retrieved_at, receipt_id and
parser_version. The existing top-level description is the short introduction
or an empty string. Omit the introduction when profile is null. Collection
happens in the serial worker, never while serving an API request.
On this page
- Read a source-native provider catalog ·
GET /providers/{provider}/models - Current official status for all reviewed serving platforms ·
GET /providers/status - Current scoped provider status ·
GET /providers/{provider}/status - Seven-day check history; not a measured uptime percentage ·
GET /providers/{provider}/status/history - Original upstream JSON bytes, SHA-256 verified; AWS uses BOM-declared UTF-16 ·
GET /providers/{provider}/status/evidence/{checksum} - List inference providers ·
GET /providers - Read an inference provider ·
GET /providers/{provider} - List a provider’s canonical models ·
GET /providers/{provider}/catalog
Read a source-native provider catalog
GET /api/v1/providers/{provider}/models
Server-cached provider metadata. Model Garden, Amazon Bedrock, Microsoft Foundry, NVIDIA, Black Forest Labs, Meta, ARC, Supernova, Alibaba Cloud Model Studio and Cheaper Inference expose pagination with total, has_more, next_offset and receipt_id. Pin receipt_id from the first page for an immutable snapshot across refreshes. Foundry includes all public nonarchived registry/model versions, including third-party and Hub models; Bedrock foundation models are scoped to the configured AWS region. Supernova offerings preserve standard/priority API IDs, base-model associations and public effective USD quotes; paused offerings retain metadata without purchasable prices. Alibaba Cloud is scoped to Singapore / international; publisher, inference provider, snapshot aliases, tiered catalog quotes and unverified currencies remain explicit. Cheaper Inference exposes its keyless public catalog; gateway attribution stays separate from model creators, and only validated single-tier standard text quotes are comparable. Credentials stay on the server. Deployment examples and hardware do not establish model limits or unit prices.
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
limit | query | No | integer Default: 500; Minimum: 1; Maximum: 1000 | Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise. |
offset | query | No | integer Default: 0; Minimum: 0 | Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0. |
provider | path | Yes | string | Registered inference-provider/source ID, such as openRouter. |
receipt_id | query | No | string · uuid | UUID of an immutable collection receipt. Omit it to use the latest source receipt. |
Request example
curl 'https://tensortrace.net/api/v1/providers/openai/models?limit=1'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Source-backed JSON response | NativeProviderModelsResponse |
400 | Invalid query | No declared JSON body |
404 | Unknown model/source | No declared JSON body |
500 | Database unavailable | No declared JSON body |
503 | Service temporarily unavailable | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{}
Type: NativeProviderModelsResponse. Provider-compatible cached catalog. DeepInfra uses a top-level array; other providers retain their native object wrappers. Each cached model object includes confirmed TensorTrace identity metadata.
Current official status for all reviewed serving platforms
GET /api/v1/providers/status
Access: public read; no TensorTrace API key.
Parameters
This operation has no path or query parameters.
Request example
curl 'https://tensortrace.net/api/v1/providers/status'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Official provider status response | object |
400 | Invalid query | No declared JSON body |
404 | Unknown provider or expired evidence | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"data": [
{
"source_id": "openRouter",
"display_name": "Model Reviewer",
"state": "operational",
"freshness": "fresh",
"scope": "example",
"feed_urls": [
"https://example.com/model"
],
"poll_interval_seconds": 1,
"scheduler_enabled": false,
"history_retention_days": 1
}
],
"as_of": "2026-10-05T00:00:00Z",
"measurement": "example",
"model_endpoint_health": false
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of ProviderStatus | Yes | |
as_of | string · date-time | Yes | |
measurement | string | Yes | |
model_endpoint_health | boolean | Yes |
Current scoped provider status
GET /api/v1/providers/{provider}/status
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
provider | path | Yes | string | Registered inference-provider/source ID, such as openRouter. |
Request example
curl 'https://tensortrace.net/api/v1/providers/openai/status'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Official provider status response | ProviderStatus |
400 | Invalid query | No declared JSON body |
404 | Unknown provider or expired evidence | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"source_id": "openRouter",
"display_name": "Model Reviewer",
"state": "operational",
"freshness": "fresh",
"scope": "example",
"feed_urls": [
"https://example.com/model"
],
"poll_interval_seconds": 1,
"scheduler_enabled": false,
"history_retention_days": 1
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
source_id | string | Yes | |
display_name | string | Yes | |
scope | string | Yes | |
page_url | string,null · uri | No | |
format | string,null | No | |
feed_urls | array of string · uri | Yes | |
component_ids | array of string | No | |
group_ids | array of string | No | |
note | string,null | No | |
state | string | Yes | Values: operational, degraded, partial_outage, major_outage, maintenance, incident_reported, no_reported_incidents, unknown |
freshness | string | Yes | Values: fresh, stale, fetch_failed, not_checked, unverified |
reported_state | string,null | No | |
checked_at | string,null · date-time | No | |
last_success_at | string,null · date-time | No | |
expires_at | string,null · date-time | No | |
consecutive_failures | integer | No | |
error_message | string,null | No | |
snapshot | object,null | No | |
evidence | array of object | No | |
poll_interval_seconds | integer | Yes | |
scheduler_enabled | boolean | Yes | |
history_retention_days | integer | Yes |
Seven-day check history; not a measured uptime percentage
GET /api/v1/providers/{provider}/status/history
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
provider | path | Yes | string | Registered inference-provider/source ID, such as openRouter. |
limit | query | No | integer Default: 20; Minimum: 1; Maximum: 100 | Number of check observations to return. Default 20; values outside 1–100 return 400. |
before | query | No | integer Minimum: 1 | Exclusive observation ID cursor returned by the status history. Must be a positive integer. |
Request example
curl 'https://tensortrace.net/api/v1/providers/openai/status/history?limit=1'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Official provider status response | object |
400 | Invalid query | No declared JSON body |
404 | Unknown provider or expired evidence | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"data": [
{}
],
"next_before": 1,
"retention_days": 1
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of object | No | |
next_before | integer,null | No | |
retention_days | integer | No |
Original upstream JSON bytes, SHA-256 verified; AWS uses BOM-declared UTF-16
GET /api/v1/providers/{provider}/status/evidence/{checksum}
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
provider | path | Yes | string | Registered inference-provider/source ID, such as openRouter. |
checksum | path | Yes | string Pattern: ^[a-fA-F0-9]{64}$ | Registered inference-provider/source ID, such as openRouter. |
Request example
curl 'https://tensortrace.net/api/v1/providers/openai/status/evidence/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Official provider status response | any JSON |
400 | Invalid query | No declared JSON body |
404 | Unknown provider or expired evidence | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
"example"
Type: any JSON.
List inference providers
GET /api/v1/providers
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
q | query | No | string | Case-insensitive search text. Omit it to browse the complete matching catalog. |
limit | query | No | integer Default: 48; Minimum: 1; Maximum: 100 | Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise. |
offset | query | No | integer Default: 0; Minimum: 0 | Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0. |
Request example
curl 'https://tensortrace.net/api/v1/providers?limit=1'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Incrementally prepared local data | DirectoryPage |
400 | Invalid query | ErrorResponse |
404 | Not present in the prepared catalog | ErrorResponse |
503 | Catalog preparation has not completed yet | ErrorResponse |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"data": [
{
"id": "openai",
"name": "OpenAI",
"role": "inference_provider",
"model_count": 1,
"description": "Illustrative model observation; consult live evidence for current specifications.",
"catalog_scope": "example"
}
],
"total_count": 1,
"limit": 1,
"offset": 0
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of Organization | Yes | Max. items: 100 |
total_count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
offset | integer | Yes | Minimum: 0 |
Read an inference provider
GET /api/v1/providers/{provider}
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
provider | path | Yes | string | Registered inference-provider/source ID, such as openRouter. |
Request example
curl 'https://tensortrace.net/api/v1/providers/openai'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Incrementally prepared local data | Organization |
400 | Invalid query | ErrorResponse |
404 | Not present in the prepared catalog | ErrorResponse |
503 | Catalog preparation has not completed yet | ErrorResponse |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"id": "openai",
"name": "OpenAI",
"role": "inference_provider",
"model_count": 1,
"description": "Illustrative model observation; consult live evidence for current specifications.",
"catalog_scope": "example"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string | Yes | |
name | string | Yes | |
role | string | Yes | Values: developer, inference_provider |
model_count | integer | Yes | Minimum: 0 |
description | string | Yes | Collected short introduction; empty when no usable official description has been collected. |
catalog_scope | string | Yes | |
aliases | array of string | No | |
logo_url | string | No | |
homepage | string,null | No | |
source_status | string | No | |
observed_at | string,null · date-time | No | |
offering_count | integer | No | |
priced_model_count | integer | No | |
best_model | object,null | No | |
governance | array of OrganizationGovernanceFinding | No | Developer company disclosure assessments, prepared independently of model matches. Empty when no assessment is recorded; omitted for inference providers. |
leading_models | array of ProviderLeadingModel | No | Up to three leaders from the developer's models or inference provider's catalog, ordered by intelligence, capability, benchmark rating, name and canonical ID. Publisher aliases are combined for developers and each canonical model appears once. Empty when no models are available; omitted by older prepared directories. Developer best_model is retained as the first entry for compatibility. Max. items: 3 |
profile | OrganizationProfile or null | No | Worker-collected company or inference-service profile. Null when unavailable; collection never runs in API requests. |
List a provider’s canonical models
GET /api/v1/providers/{provider}/catalog
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
provider | path | Yes | string | Registered inference-provider/source ID, such as openRouter. |
q | query | No | string | Case-insensitive search text. Omit it to browse the complete matching catalog. |
query | query | No | string | Alternative spelling of q; when both are supplied, query takes precedence. |
provider | query | No | string | Model publisher namespace. For serving-platform filters, use inference_provider instead. |
source | query | No | string | Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer. |
price | query | No | string | Pricing class: all, free or paid. Uses comparable basic token prices; an unknown price is not free. |
capability | query | No | string | Comma-separated capability identifiers; all must match. |
input_modality | query | No | string | Match an input modality, such as text, image, audio or video. Obtain current values from /facets/models. |
model_type | query | No | string Max. length: 64 | Match a displayed model classification, including secondary types. Use multimodal for MLLM, vlm for image-only VLM, llm for text LLM, or another model type ID from a classification link. unknown selects models without reported classification evidence. Omit or use all for no type filter. Combines with other discovery filters before pagination and counts; an unrecognized ID returns an empty result. |
output_modalities | query | No | string | Comma-separated output modalities; matches models with any listed output modality. all disables this filter. |
sort | query | No | string Default: "intelligence" | Defaults to Intelligence Index descending; unscored models follow using capability, rating and name as deterministic fallbacks. Price sorts use the card-selected USD Input then Output rates, with missing rates last; cache rates do not participate. Tied basic offerings prefer the model developer. Provider-scoped sorts apply the same policy within that source's quotes. |
limit | query | No | integer Default: 48; Minimum: 1; Maximum: 100 | Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise. |
offset | query | No | integer Default: 0; Minimum: 0 | Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0. |
identity_kind | query | No | string Values: model, family | Restrict identities to a concrete model or a model family; omit to include both. |
developer | query | No | string | Canonical developer ID; groups reviewed publisher aliases. |
inference_provider | query | No | string | Registered inference source ID; selects current source offerings, including price-only records. Adds source-scoped provider_prices; other model fields retain canonical scope. |
Request example
curl 'https://tensortrace.net/api/v1/providers/openai/catalog?limit=1'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Incrementally prepared local data | ModelPage |
400 | Invalid query | ErrorResponse |
404 | Not present in the prepared catalog | ErrorResponse |
503 | Catalog preparation has not completed yet | ErrorResponse |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"data": [
{
"id": "openai/gpt-4.1",
"canonical_model_id": "openai/gpt-4.1",
"provider": "openai",
"name": "OpenAI: GPT-4.1",
"official_model_id": "gpt-4.1",
"developer_id": "openai",
"developer_name": "OpenAI",
"description": "Illustrative model observation; consult live evidence for current specifications.",
"context_length": 1048576
}
],
"total_count": 1,
"limit": 1,
"offset": 0
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of CatalogModel | Yes | Max. items: 100 |
total_count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
offset | integer | Yes | Minimum: 0 |