Saltar al contenido principal
GET
Listar los modelos y precios de Devin Desktop

Descripción general

Devuelve los modelos disponibles para la cuenta que realiza la llamada, con los precios que realmente se cobran a esa cuenta, si tu equipo permite actualmente cada uno de ellos y la lista de modelos permitidos que el equipo tiene guardada. Úsalo como fuente de verdad programática para los precios de los modelos, en lugar de copiarlos desde la página de modelos, y como la operación de lectura complementaria de la API de actualización de la lista de modelos permitidos. 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.
Este endpoint está en alfa (v2alpha). La estructura de la respuesta puede cambiar.

Autenticación

Envía una clave de API en el encabezado Authorization:
Usa una clave de API de usuario de servicio de Devin (cog_...). El rol del usuario de servicio debe incluir el permiso Use Devin Desktop y el permiso Windsurf admin (account.windsurf.admin), que ya incluye el rol integrado Account Admin, y la cuenta debe tener habilitado el acceso a Devin Desktop.

solicitud

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. El campo allowed de cada modelo indica si las restricciones de tu equipo lo permiten actualmente.Establécelo en allowlist para listar solo los modelos que autorizan 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.
string
Limita el ámbito de la respuesta a una organización de tu cuenta. En ese caso, las opciones allowed reflejan la anulación de la lista de modelos permitidos de esa organización (o la lista de permitidos de toda la cuenta si la organización no tiene ninguna), y allowed_model_uids / allowed_model_tags contienen la anulación almacenada de la propia organización (arrays vacíos si no tiene ninguna). El ETag es específico de la organización; pásalo como If-Match al actualizar esa organización.Déjalo sin definir para usar la lista de permitidos de toda la cuenta.
string
Un ETag de una respuesta anterior. Devuelve 304 Not Modified sin cuerpo si la respuesta no ha cambiado desde entonces.

Ejemplo de solicitud

Solo los modelos que tus usuarios pueden elegir:

Respuesta

La respuesta incluye un encabezado ETag que cambia cada vez que se modifica cualquier elemento de la respuesta sin filtrar: los modelos disponibles, sus nombres y precios, sus opciones allowed o los campos de la lista de permitidos. Pásalo como If-Match a la API de actualización de la lista de modelos permitidos; su valor es el mismo independientemente de filter.
object[]
Modelos disponibles para quien realiza la llamada. No se incluyen los modelos deshabilitados.
string[]
UID de los modelos incluidos en la lista de permitidos de tu equipo, tal como están almacenados. Vacío cuando el equipo solo permite modelos por etiqueta.
string[]
Etiquetas de modelos incluidas en la lista de permitidos de tu equipo, tal como están almacenadas, incluidas las etiquetas de proveedor como provider-anthropic. Un modelo está permitido si su UID figura en la lista o si tiene alguna de las etiquetas incluidas.

Ejemplo de respuesta

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.

Respuestas de error

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