Skip to main content
Use this route to retrieve the model IDs currently visible to your account. /v1/models returns PipeLLM’s unified model schema, not the native OpenAI or Anthropic list-model format.

​
Endpoint

GET https://api.pipellm.ai/v1/models

​
Authentication

Use a standard PipeLLM API key header:
HeaderExample
AuthorizationBearer $PIPELLM_API_KEY
x-api-key$PIPELLM_API_KEY

​
Notes

  • This route only supports GET.
  • The response is PipeLLM’s unified schema.
  • Hidden and unlisted models are filtered out before the response is returned.
  • Results are sorted by model ID.
  • Each model includes a pricing object by default. PipeLLM groups pricing by billing shape instead of exposing raw mapping table field names.

​
Example Requests

curl https://api.pipellm.ai/v1/models \
  -H "Authorization: Bearer $PIPELLM_API_KEY"

​
Response Format

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5",
      "display_name": "Gpt 5",
      "type_target": "openai",
      "created_at": "2025-05-14T00:00:00Z",
      "pricing": {
        "kind": "token",
        "text": {
          "prompt": "0.000003",
          "completion": "0.000015",
          "internal_reasoning": "0.000015"
        },
        "cache": {
          "read": "0.000001",
          "write": "0.00000375",
          "write_1h": "0.0000075"
        },
        "tiers": {
          "over_200k": {
            "text": {
              "prompt": "0.0000055",
              "completion": "0.000022",
              "internal_reasoning": "0.000022"
            },
            "cache": {
              "read": "0.0000009",
              "write": "0.0000033",
              "write_1h": "0.0000066"
            }
          }
        }
      }
    },
    {
      "id": "sora-2",
      "display_name": "Sora 2",
      "type_target": "openai",
      "created_at": "2025-03-01T00:00:00Z",
      "pricing": {
        "kind": "generation",
        "generation": {
          "video": {
            "per_second": "0.1",
            "per_second_with_audio": "0.2"
          }
        }
      }
    }
  ],
  "total": 2
}
Token-priced fields are returned as USD per token. Generation-priced fields use their natural billing units, such as USD per image or USD per second.

​
Response Fields

FieldTypeDescription
objectstringAlways "list"
dataarrayArray of model objects
data[].idstringModel ID used in API requests
data[].display_namestringHuman-readable label generated from the model ID
data[].type_targetstringTarget protocol family for routing, such as openai, anthropic, or gemini
data[].created_atstringRFC3339 timestamp chosen from the model metadata
data[].pricingobjectPricing returned with the model by default
data[].pricing.kindstringBilling shape for the model, currently token or generation
data[].pricing.textobjectBase token pricing for text or multimodal-understanding models
data[].pricing.text.promptstringInput token price in USD per token
data[].pricing.text.completionstringOutput token price in USD per token
data[].pricing.text.internal_reasoningstringHidden internal reasoning token price in USD per token for OpenAI thinking models. When present, it follows the billed completion/output rate.
data[].pricing.cacheobjectCache pricing for token-based models when available
data[].pricing.cache.readstringCache read price in USD per token
data[].pricing.cache.writestringCache write price in USD per token
data[].pricing.cache.write_1hstring1-hour cache write price in USD per token
data[].pricing.multimodalobjectToken-based multimodal pricing when available
data[].pricing.multimodal.input_imagestringInput image token price in USD per token
data[].pricing.multimodal.output_imagestringOutput image token price in USD per token
data[].pricing.tiersobjectTiered pricing when the model has alternate rates
data[].pricing.tiers.over_200kobjectPricing used above the 200k token tier
data[].pricing.generationobjectOutput-generation pricing for pure image, audio, or video models
data[].pricing.generation.image.per_imagestringImage generation price in USD per image
data[].pricing.generation.audio.per_secondstringAudio generation price in USD per second
data[].pricing.generation.video.per_secondstringVideo generation price in USD per second
data[].pricing.generation.video.per_second_with_audiostringVideo-with-audio generation price in USD per second
totalintegerTotal number of returned models

​
Why This Route Matters

Use /v1/models when you need to:
  • populate a model picker in your UI
  • validate whether a model is visible to the current account
  • decide which protocol family a model is exposed under

API Reference Overview

Public routes, protocol families, and routing rules

Routing & Protocols

Understand how model protocol families affect requests

Developer Tools

Use these model IDs in Claude Code, OpenCode, OpenClaw, and LangChain