Providers API
The Providers API lists inference providers and their API configuration, supported regions and confirmed model mappings. For text search, use the Search API.
List Providers
GET /api/providersList inference providers with pagination, sorted by name.
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | 1 | Page number (1-indexed) |
limit | integer | No | 20 | Items per page (max 100) |
Example Request
curl "https://api.openmodels.run/api/providers?page=1&limit=10"Example Response
{
"items": [
{
"id": "openai",
"name": "OpenAI",
"description": "Leading AI research company providing API access to GPT-4, GPT-3.5, DALL-E, and other foundation models through a developer-friendly REST API with global availability.",
"api_base_url": "https://api.openai.com/v1",
"auth_type": "bearer",
"regions": ["us-east-1", "eu-west-1"],
"compatibility": "openai",
"created_at": "2024-01-01T00:00:00.000Z",
"updated_at": "2024-06-15T00:00:00.000Z"
},
{
"id": "together-ai",
"name": "Together AI",
"description": "Cloud platform for running and fine-tuning open-source models with high throughput inference and competitive pricing across a wide range of LLMs.",
"api_base_url": "https://api.together.xyz/v1",
"auth_type": "bearer",
"regions": ["us-east-1", "eu-west-1"],
"compatibility": "openai",
"created_at": "2024-02-01T00:00:00.000Z",
"updated_at": "2025-03-10T00:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 2,
"total_pages": 1
}
}Response Fields
| Field | Type | Description |
|---|---|---|
items | array | Array of provider objects |
items[].id | string | Unique provider identifier (kebab-case) |
items[].name | string | Human-readable display name |
items[].description | string | Detailed description of the provider |
items[].api_base_url | string | Base URL for the provider’s API |
items[].auth_type | string | Authentication method (bearer, api-key, header) |
items[].regions | string[] | Supported deployment regions |
items[].compatibility | string | API compatibility layer (e.g. openai, anthropic) |
items[].created_at | string | ISO 8601 timestamp when the provider was added |
items[].updated_at | string | ISO 8601 timestamp when the provider was last updated |
pagination.page | integer | Current page number |
pagination.limit | integer | Items per page |
pagination.total | integer | Total number of matching providers |
Error Responses
| Status | Type | Description |
|---|---|---|
400 | BAD_REQUEST | Invalid query parameters (e.g. limit exceeds 100) |
Get Provider
GET /api/providers/:idRetrieve full details for a single provider by its unique identifier.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The provider’s unique identifier (e.g. openai, anthropic) |
Example Request
curl "https://api.openmodels.run/api/providers/anthropic"Example Response
{
"id": "anthropic",
"name": "Anthropic",
"description": "AI safety company providing API access to the Claude family of models, known for helpfulness, harmlessness, and honesty with strong reasoning and analysis capabilities.",
"api_base_url": "https://api.anthropic.com/v1",
"auth_type": "api-key",
"regions": ["us-east-1", "eu-west-1"],
"compatibility": "anthropic",
"models": [],
"created_at": "2024-01-01T00:00:00.000Z",
"updated_at": "2024-06-15T00:00:00.000Z"
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique provider identifier (kebab-case) |
name | string | Human-readable display name |
description | string | Detailed description of the provider |
api_base_url | string | Base URL for the provider’s API |
auth_type | string | Authentication method (bearer, api-key, oauth2, basic, none) |
regions | string[] | Supported deployment regions |
compatibility | string | API compatibility layer (e.g. openai, anthropic) |
models | array | Hosted mappings with model IDs, endpoints, prices and limits; can be empty |
created_at | string | ISO 8601 timestamp when the provider was added |
updated_at | string | ISO 8601 timestamp when the provider was last updated |
Error Responses
| Status | Type | Description |
|---|---|---|
404 | NOT_FOUND | Provider with the given ID does not exist |