List models with filters

curl -G https://api.respan.ai/api/models/list/ \
     -H "Authorization: Bearer sk_live_7f8e9d0a1b2c3d4e5f6g7h8i9j0k" \
     -H "Content-Type: application/json" \
     -d sort_by=-input_cost \
     -d page=2 \
     -d page_size=25 \
     -d all=false

{
  "count": 150,
  "results": [
    {
      "id": "my-custom-gpt-4o",
      "model_name": "my-custom-gpt-4o",
      "display_name": "My Custom GPT-4o",
      "base_model_name": "gpt-4o",
      "affiliation_category": "custom",
      "is_called_by_custom_name": false,
      "input_cost": 2.5,
      "output_cost": 10,
      "cache_hit_input_cost": 0.5,
      "cache_creation_input_cost": 3,
      "max_context_window": 128000,
      "streaming_support": 1,
      "function_call": 1,
      "image_support": 1,
      "source": "db",
      "model_type": "chat",
      "supported_params": {
        "temperature": true,
        "max_tokens": true,
        "top_p": true,
        "frequency_penalty": true,
        "presence_penalty": true
      },
      "throughput": {
        "average_tps": 12.4,
        "average_ttft": 0.85,
        "average_latency": 1.2,
        "number_of_requests": 3450
      },
      "provider": {
        "id": "my-vllm",
        "provider_id": "my-vllm",
        "provider_name": "My vLLM Server",
        "extra_kwargs": {
          "base_url": "https://vllm.example.com/v1",
          "timeout_seconds": 30
        },
        "created_at": "2024-01-15T09:30:00Z",
        "updated_at": "2024-04-10T11:45:00Z"
      },
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-10T11:45:00Z"
    }
  ],
  "next": "https://api.respan.ai/api/models/list/?page=3&page_size=25&sort_by=-input_cost",
  "previous": "https://api.respan.ai/api/models/list/?page=1&page_size=25&sort_by=-input_cost",
  "current_filters": {
    "page": 2,
    "page_size": 25,
    "sort_by": "-input_cost",
    "all": false
  }
}

List models with pagination, standard filters, sorting, and recent global throughput metrics.

Query parameters

pageintegerOptional>=1

Page number.

page_sizeintegerOptional1-100

Number of results to return per page. Maximum 100.

sort_bystringOptionalDefaults to model_name

Field to sort by. Prefix with - for descending order.

allbooleanOptionalDefaults to false

If true, return all matching models without pagination for routes that support it.

Response

Paginated list of models.

countinteger

Total number of matching models.

resultslist of objects

nextstring or null

URL for the next page, if any.

previousstring or null

URL for the previous page, if any.

current_filtersobject

Normalized filters applied to this request.

Errors

401

Unauthorized Error

Headers

Query parameters

Response

Errors