> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar los modelos y precios de Devin Desktop

> Lista los modelos de Devin Desktop disponibles en tu cuenta, con sus UID de modelo, sus nombres y los precios por token o por mensaje que se le cobran a tu equipo.

<div id="overview">
  ## Descripción general
</div>

Devuelve los modelos disponibles para la cuenta que realiza la llamada, con los precios que realmente se cobran a esa cuenta. Úsalo como fuente de verdad programática para los precios de los modelos, en lugar de copiarlos desde la [página de modelos](/es/desktop/models).

Los precios dependen del plan y del modelo de facturación de quien realiza la llamada, por lo que dos equipos pueden obtener valores distintos para el mismo modelo.

<Note>Este endpoint está en alfa (`v2alpha`). La estructura de la respuesta puede cambiar.</Note>

<div id="authentication">
  ## Autenticación
</div>

Envía una clave de API en el encabezado `Authorization`:

```
Authorization: Bearer <api-key>
```

Usa una [clave de API de usuario de servicio](/es/api-reference/authentication) de Devin (`cog_...`). El rol del usuario de servicio debe incluir el permiso **Use Devin Desktop** y la cuenta debe tener habilitado el acceso a Devin Desktop.

<div id="request">
  ## solicitud
</div>

<ParamField query="filter" type="string">
  Déjalo sin definir para listar todos los modelos permitidos por tu plan y tu modelo de facturación, ignorando las restricciones a nivel de equipo.

  Establécelo en `allowlist` para aplicar también la lista de modelos permitidos de tu equipo, los controles de la organización y las restricciones de grupo, de modo que la lista coincida con la que ven los usuarios en el selector de modelos de Devin Desktop.
</ParamField>

<div id="example-request">
  ### Ejemplo de solicitud
</div>

```bash theme={null}
curl https://server.codeium.com/api/v2alpha/models \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

Solo los modelos que tus usuarios pueden elegir:

```bash theme={null}
curl "https://server.codeium.com/api/v2alpha/models?filter=allowlist" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="response">
  ## Respuesta
</div>

<ResponseField name="models" type="object[]">
  Modelos disponibles para quien realiza la llamada. No se incluyen los modelos deshabilitados.

  <Expandable title="propiedades">
    <ResponseField name="uid" type="string">
      Identificador estable del modelo, p. ej. `claude-sonnet-4-5`.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nombre que se muestra en el selector de modelos.
    </ResponseField>

    <ResponseField name="pricing_dimensions" type="object[]">
      Precios que se cobran a quien realiza la llamada por este modelo. Vacío en el caso de los modelos sin cargo.

      <Expandable title="propiedades">
        <ResponseField name="label" type="string">
          Aquello a lo que se aplica el precio, en snake\_case: `input`, `output`, `cached_input`, `cache_read` o `cache_write` para el precio por tokens; para precios en una unidad distinta de la moneda, la cantidad tarificada, p. ej. `message` para el precio por mensaje. Los modelos Fusion también listan los precios de su modelo secundario con el prefijo `sidekick_`, p. ej. `sidekick_input` o `sidekick_message`.
        </ResponseField>

        <ResponseField name="unit" type="string">
          La unidad en la que se expresa `value`, en snake\_case, p. ej. `usd`, `acus` o `credits`.
        </ResponseField>

        <ResponseField name="value" type="number">
          El precio en `unit`, por `denominator`.
        </ResponseField>

        <ResponseField name="denominator" type="string">
          La cantidad a la que se aplica el precio, p. ej. `1M tokens` o `message`.
        </ResponseField>

        <ResponseField name="info" type="string">
          Nota opcional sobre el precio, p. ej. `Higher effort consumes more tokens`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Ejemplo de respuesta
</div>

Los modelos y precios que se muestran a continuación solo ilustran la estructura de la respuesta. Llama al endpoint para consultar tus precios reales.

```json theme={null}
{
  "models": [
    {
      "uid": "claude-sonnet-4-5",
      "name": "Claude Sonnet 4.5",
      "pricing_dimensions": [
        { "label": "input", "unit": "usd", "value": 3, "denominator": "1M tokens" },
        { "label": "cached_input", "unit": "usd", "value": 0.3, "denominator": "1M tokens" },
        { "label": "output", "unit": "usd", "value": 15, "denominator": "1M tokens" }
      ]
    },
    {
      "uid": "example-model",
      "name": "Example Model",
      "pricing_dimensions": [
        { "label": "message", "unit": "acus", "value": 0.5, "denominator": "message" }
      ]
    }
  ]
}
```

<div id="error-responses">
  ## Respuestas de error
</div>

Los errores se devuelven como `{"error": "<message>"}`.

| Estado | Causa                                                                                                              |
| ------ | ------------------------------------------------------------------------------------------------------------------ |
| `400`  | `filter` tiene un valor distinto de `allowlist`                                                                    |
| `401`  | Clave de API ausente o no válida                                                                                   |
| `403`  | El usuario de la clave no tiene acceso a Devin Desktop                                                             |
| `429`  | Se superó el límite de tasa; espera el tiempo indicado en el encabezado `Retry-After` antes de volver a intentarlo |