> ## Documentation Index > Fetch the complete documentation index at: https://docs.pre.dev/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Agents: start with https://docs.pre.dev/agents.md, which has complete recipes, plan access, polling rules, errors and limits. > Authenticate with the workspace API key (pdk_…) from Integrations → Built-in, sent as Authorization: Bearer . > REST API: https://api.pre.dev (OpenAPI: https://docs.pre.dev/api-reference/openapi.json). AI Gateway: https://api.pre.dev/v1, OpenAI-compatible (OpenAPI: https://docs.pre.dev/api-reference/ai-gateway.openapi.json). > pre.dev MCP server: https://api.pre.dev/mcp. Search these docs over MCP at https://docs.pre.dev/mcp. # List models without a key > Every model an app can call, with its lab and modalities and no prices. Needs no API key. ## OpenAPI ````yaml api-reference/ai-gateway.openapi.json GET /v1/models/public openapi: 3.1.0 info: title: pre.dev AI Gateway API version: 1.0.0 description: >- One OpenAI-compatible API for hundreds of models from every major lab, paid for in pre.dev credits. - **Base URL:** `https://api.pre.dev/v1` for the OpenAI SDKs. The Anthropic SDKs take `https://api.pre.dev` and add `/v1/messages` themselves. - **Auth:** the workspace API key (`pdk_…`) from Integrations → Built-in in the pre.dev dashboard, as `Authorization: Bearer ` or `x-api-key`. Keep it on a server: it spends the workspace's credits. - **Models:** send ids exactly as `GET /v1/models` lists them, such as `anthropic/claude-sonnet-5`. - **Public directory:** `GET /v1/models/public` lists every model with no key and no prices. - **Charges:** each call is charged in credits from its metered cost. Non-streaming responses report the charge in `x-predev-credits-charged`; `GET /v1/generation` reports it for any call. A request is refused with `402` before it runs when the balance cannot cover it. Catalog, usage, generation and file reads are free. - **Limits:** 600 requests per minute per workspace, 30 on the free trial. A free workspace can spend 5 credits on AI calls in total, then gets `402 subscription_required`. Reads other than `GET /v1/files` do not count toward the per-minute limit. - **Errors:** errors raised by pre.dev use the OpenAI error shape with a `predev` object (`GatewayError`). Errors from the model keep their HTTP status and message (`ModelError`). Every inference response carries `x-predev-request-id`. - **Streaming:** `stream: true` returns server-sent events in the native format of each endpoint. Lines that start with `:` are keep-alives. Example values are illustrative. contact: name: pre.dev Support url: https://pre.dev email: support@pre.dev license: name: Proprietary url: https://pre.dev/terms servers: - url: https://api.pre.dev description: Production security: - apiKeyAuth: [] - xApiKey: [] tags: - name: Chat description: Chat completions, text completions, Responses and Messages. - name: Embeddings description: Embeddings and rerank. - name: Images and video description: Image generation and asynchronous video jobs. - name: Audio description: Speech, music and transcription. - name: Files description: Documents stored for later chat requests. - name: Models description: The model catalog, with credit prices. - name: Usage description: Usage totals and per-call stats. paths: /v1/models/public: get: tags: - Models summary: List models without a key description: >- Every model an app can call, with its lab, type and modalities, and no prices. Needs no API key, so a page can show the catalog. Credit prices are on `GET /v1/models`. Responses can be cached for 10 minutes; send the `ETag` back in `If-None-Match` to get `304` when nothing changed. operationId: listPublicModels parameters: - name: If-None-Match in: header required: false schema: type: string description: The `ETag` from an earlier response. responses: '200': description: The model directory. headers: ETag: description: Changes when the catalog changes. schema: type: string Cache-Control: description: '`public, max-age=600, stale-while-revalidate=86400`' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ModelDirectory' example: object: list updated_at: '2026-09-27T19:34:01.315Z' total: 2 counts: text: 1 image: 0 video: 0 embeddings: 1 labs: - id: anthropic name: Anthropic models: 1 - id: openai name: OpenAI models: 1 data: - id: anthropic/claude-sonnet-5 name: Claude Sonnet 5 lab: anthropic type: text input: - text - image - file output: - text context_length: 1000000 created: 1782843083 - id: openai/text-embedding-3-small name: Text Embedding 3 Small lab: openai type: embeddings input: - text output: - embeddings context_length: 8192 created: 1761857455 '304': description: Not modified since the `ETag` you sent. '500': $ref: '#/components/responses/ServerError' '503': description: The catalog is refreshing. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: message: The model catalog is refreshing. Try again in a minute. type: server_error code: catalog_unavailable param: null predev: {} security: [] components: schemas: ModelDirectory: type: object required: - object - updated_at - total - counts - labs - data properties: object: type: string const: list updated_at: type: string format: date-time description: When the catalog behind this list was last refreshed. total: type: integer counts: type: object required: - text - image - video - embeddings properties: text: type: integer image: type: integer video: type: integer embeddings: type: integer labs: type: array description: Labs by number of models, most first. items: type: object required: - id - name - models properties: id: type: string name: type: string models: type: integer data: type: array description: Newest first. items: type: object required: - id - name - lab - type - input - output - context_length - created properties: id: type: string description: The id to send as `model`. name: type: string lab: type: string type: type: string enum: - text - image - video - embeddings input: type: array items: type: string output: type: array items: type: string context_length: type: - integer - 'null' created: type: - integer - 'null' GatewayError: type: object description: >- An error raised by pre.dev, in the OpenAI error shape with an extra `predev` object (absent on `catalog_unavailable` from the catalog listings). Branch on `error.code`. required: - error properties: error: type: object required: - message - type - code - param properties: message: type: string description: What went wrong and what to do next. type: type: string enum: - authentication_error - insufficient_credits - subscription_required - invalid_request_error - not_found_error - rate_limit_error - server_error description: >- Error class. The OpenAI and Anthropic SDKs map the HTTP status to their own exception types. code: type: string enum: - missing_api_key - invalid_api_key - too_many_auth_failures - insufficient_credits - subscription_required - rate_limit_exceeded - balance_unavailable - invalid_request - missing_id - not_found - not_ready - upstream_unavailable - catalog_unavailable - internal_error description: >- | Code | HTTP | Meaning | | --- | --- | --- | | `missing_api_key` | 401 | No `Authorization: Bearer` or `x-api-key` header. | | `invalid_api_key` | 401 | The key is unknown, or was rotated more than 15 minutes ago. | | `too_many_auth_failures` | 429 | More than 30 failed key attempts from this IP address in a minute. | | `insufficient_credits` | 402 | The balance is zero or below the estimate for this request. Nothing ran. | | `subscription_required` | 402 | A free workspace used its 5 credits of AI calls. | | `rate_limit_exceeded` | 429 | Over the per-minute request limit for the workspace. | | `balance_unavailable` | 503 | The balance could not be read. Nothing ran. | | `invalid_request` | 400 | `/v1/audio/speech` is missing `model` or `input`, or the model does not produce audio. | | `missing_id` | 400 | `/v1/generation` was called without `id`. | | `not_found` | 404 | Unknown path, or a file, video job, response or generation that belongs to another workspace, including one a request refers to. | | `not_ready` | 404 or 502 | Generation stats are not available yet. | | `upstream_unavailable` | 502 | The model did not answer, or returned no audio. | | `catalog_unavailable` | 502 or 503 | The model catalog could not be read: 502 from the catalog listings, 503 from `GET /v1/models/public`. Retry shortly. | | `internal_error` | 500 | Unexpected error. | param: type: 'null' predev: $ref: '#/components/schemas/GatewayErrorDetails' GatewayErrorDetails: type: object description: Extra fields for some error codes; an empty object for the rest. properties: credits_remaining: type: number description: >- Workspace balance. Sent with `insufficient_credits` and `subscription_required`. estimated_credits: type: number description: >- Estimated credits the request needs. Sent with `insufficient_credits`. trial_credits_used: type: number description: >- Credits the free trial has spent on AI calls. Sent with `subscription_required`. topup_url: type: string format: uri description: Where to add credits or subscribe. retry_after: type: integer description: Seconds to wait. Also sent as the `Retry-After` header. available_models: type: array items: type: string description: >- Speech and music model ids. Sent with `invalid_request` from `/v1/audio/speech`. responses: ServerError: description: Unexpected error. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: message: The pre.dev AI gateway hit an unexpected error. type: server_error code: internal_error param: null predev: {} securitySchemes: apiKeyAuth: type: http scheme: bearer bearerFormat: pdk_ API key description: >- The workspace API key (`pdk_…`) from Integrations → Built-in in the pre.dev dashboard. xApiKey: type: apiKey in: header name: x-api-key description: >- Alternative to `Authorization: Bearer`. The Anthropic SDKs send this header. ````