> ## Documentation Index > Fetch the complete documentation index at: https://docs.vocily.ai/llms.txt > Use this file to discover all available pages before exploring further. # Models > The LLMs you can put in `model.model`. Every model in this list can be used. There is nothing here to filter out. **Two prices.** `rate_per_min` is what a minute of voice costs. `chat_price_per_reply` is what one chat or WhatsApp reply costs. They are separate prices, so quote the one for the channel you are talking about. Either is `null` when the model cannot be used on that channel. `is_default` marks the model an agent gets when you leave `model` out. ```http theme={"dark"} GET /v1/models ``` ```json theme={"dark"} { "models": [ { "id": "gpt-5.4-nano", "label": "GPT-5.4 Nano", "provider": "openai", "provider_label": "OpenAI", "is_default": true, "rate_per_min": 0.004, "chat_price_per_reply": 0.004 } ] } ``` `provider` and `id` are the two machine values: they go into `model.provider` and `model.model` on [`PATCH /v1/agents/{agent_id}`](/developers/agents/update). ## OpenAPI ````yaml developers/openapi.json GET /v1/models openapi: 3.1.0 info: title: Vocily API description: >- Public REST API for Vocily. Build and configure an agent, publish a version and put it live, place outbound calls, and read back calls, chats and what the agent remembered. Authenticate with a workspace API key as a Bearer token. Some things stay in the dashboard, by design: creating an API key, buying or connecting a phone number, setting an agent's webhook URL, connecting WhatsApp and its templates, building HTTP tools, and running batch campaigns. version: v1 servers: - url: https://api.vocily.ai description: Production security: [] paths: /v1/models: get: tags: - models summary: List Models description: >- LLMs you can put in `model.model`. `rate_per_min` is what this model contributes to a voice minute — **not** the price of a call, which also carries speech recognition, the voice and telephony. `chat_price_per_reply` is what one chat or WhatsApp reply costs. Each is null when the model is not available on that channel. `is_default` marks the one an agent gets when you omit `model`. `supports_temperature` says whether a custom `model.temperature` is honoured. It is accepted on every model, to match the dashboard, so read this before setting one: on a model that reports `false` the value is stored and the call runs at the model's own default. operationId: list_models_v1_models_get parameters: [] responses: '200': description: LLMs you can put in `model.model`. content: application/json: schema: type: object properties: models: type: array items: type: object properties: id: type: string description: What goes in `model.model`. label: type: string provider: type: string enum: - openai - gemini - sarvam description: >- Who runs this model. `model.provider` on an agent is derived from the model id, so there is nothing to set. provider_label: type: string is_default: type: boolean description: The model an agent gets when you omit `model`. supports_temperature: type: boolean description: >- Whether a custom `model.temperature` is honoured. `temperature` is accepted on every model, so read this first: where it is `false`, the value is stored and the call runs at the model's own default. rate_per_min: type: number nullable: true description: >- USD this model contributes to a voice minute — not the price of a call, which also carries speech recognition, the voice and telephony. Null if this model cannot be used for voice. chat_price_per_reply: type: number nullable: true description: >- Price in USD for one chat or WhatsApp reply. This is a separate price from `rate_per_min`, not the same figure in different units. Null if this model cannot be used for chat. example: models: - id: gpt-5-nano label: GPT-5 Nano provider: openai provider_label: OpenAI is_default: false rate_per_min: 0.001 chat_price_per_reply: 0.001 - id: sarvam-105b-conversations label: Sarvam-105B provider: sarvam provider_label: Sarvam AI is_default: false rate_per_min: 0.002 chat_price_per_reply: 0.002 '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: detail: Invalid API key code: UNAUTHORIZED '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded — honor `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: code: rate_limited security: - bearerAuth: [] components: schemas: ApiError: type: object description: >- Error envelope. `code` is derived from the HTTP status, so branch on it for the CLASS of failure; the specific reason is `detail.code`. Every public refusal carries both. properties: detail: type: object description: >- The reason. `code` is the domain reason (e.g. `call_not_found`) and `message` is a sentence safe to log. On a `422` it also carries `errors[]`, one entry per rejected field — see `HTTPValidationError`. properties: code: type: string example: call_not_found message: type: string example: Call not found required: - code - message code: type: string description: Derived from the HTTP status, not the domain reason. example: NOT_FOUND HTTPValidationError: type: object title: HTTPValidationError description: >- A request the API could not read: a field of the wrong type, out of range, missing, or one we do not accept. Same envelope as every other error. properties: detail: type: object description: >- What was wrong, as `code`, a one-line `message`, and every offending field in `errors`. required: - code - message - errors properties: code: type: string enum: - validation_error message: type: string description: >- The first problem in one line, with a count of the rest — e.g. `model.temperature: Input should be less than or equal to 2 (and 1 more)`. errors: type: array items: $ref: '#/components/schemas/ValidationError' description: >- One entry per offending field. **Every problem is reported at once**, not just the first, so a malformed body needs one round trip to fix rather than one per field. code: type: string enum: - VALIDATION_ERROR description: Derived from the HTTP status, as on every error. ValidationError: type: object title: ValidationError required: - field - message - type properties: field: type: string description: >- The offending field as a path from the root of your request — `voice.speed`, `variables[0].key`, or `query.limit` for a query parameter. **This is the field to read.** message: type: string description: What is wrong with it, in plain language. type: type: string description: >- A stable machine code for the kind of failure, e.g. `extra_forbidden` for a field we do not accept, `missing` for a required one, or `less_than_equal` for a number out of range. Switch on this rather than on `message`, which may be reworded. securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key as a Bearer token, e.g. `Authorization: Bearer vk_…`.' ````