Models Endpoint | Parasail
List of Available Models on the Parasail Platform
This endpoint works on the standard gateway and serves both the chat completions and Responses APIs.
Endpoint
GET https://api.parasail.io/v1/models
Authentication
Pass your API key in the Authorization header:
Authorization: Bearer <PARASAIL_API_KEY>
See Authentication for how to create and store a key.
Request
cURL
curl https://api.parasail.io/v1/models \
-H "Authorization: Bearer $PARASAIL_API_KEY"
Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://api.parasail.io/v1",
api_key="<PARASAIL_API_KEY>"
)
models = client.models.list()
for model in models.data:
print(model.id)
Response
A successful request returns a list of model objects:
{
"object": "list",
"data": [
{
"id": "parasail-deepseek-r1",
"object": "model",
"created": 1727900000,
"owned_by": "parasail"
}
]
}
Field Descriptions
| Field | Description |
|---|---|
data[].id |
Model ID to pass as model in other requests |
data[].object |
Always model |
data[].owned_by |
Owner of the model |
The list is returned in full in a single response—this endpoint is not paginated. See the OpenAI models reference for field semantics.
Model Types
Parasail supports several types of models:
Serverless models—prefixed with
parasail-(for example,parasail-deepseek-r1). Available on the serverless tier with token-based pricing.Dedicated deployments—use the deployment name as the model ID. Available on dedicated instances.
HuggingFace models—any HuggingFace transformer can be used with batch or dedicated endpoints by specifying the full HuggingFace ID (for example,
NousResearch/DeepHermes-3-Mistral-24B-Preview).
Error Responses
Errors use OpenAI-compatible status codes and a JSON body with an error object (message, type, code).
| Status Code | Description |
|---|---|
401 |
Missing or invalid API key |
403 |
API key lacks access to list models |
429 |
Rate limit or quota exceeded—back off and retry |
500 |
Internal server error—retry with exponential backoff |
Next Steps
- Chat completions API—use a model ID to run inference
- Serverless overview—list of available serverless models
- Model selection—choose models by workload and check availability
- Pricing—pricing by model parameter count