Models Endpoint

List available models on the Parasail platform using the /v1/models endpoint.

List all 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	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