API para desarrolladores
Proset expone una API REST y un servidor MCP (Model Context Protocol) alojado. Ambos se autentican con una clave de API de desarrollador y operan únicamente sobre los datos y el plan del propietario de la clave.
Acceso y autenticación
- URL base de REST:
https://proset.ai/api/v1 - URL de MCP:
https://proset.ai/mcp - Autenticación: envía la clave de API como token de portador (bearer token) en el encabezado
Authorization.
Las claves de API usan el formato proset_ seguido de 64 caracteres hexadecimales. Una clave se muestra una sola vez al crearla, se guarda como un hash unidireccional y se puede revocar en cualquier momento. La caducidad predeterminada es de 90 días; las claves también pueden caducar a los 30 o 365 días, o nunca.
Las claves se crean y se administran en la app, en Ajustes → Desarrollador, no a través de la propia API.
Endpoints REST
| Método | Ruta | Propósito |
|---|---|---|
| POST | /transcribe | Transcribe un archivo de audio o audio en base64 a texto. |
| POST | /convert | Convierte una transcripción en un artefacto como un resumen, un correo o una hoja de cálculo. |
| GET | /me | Devuelve el perfil, el plan y el uso del propietario de la clave. |
| GET | /usage | Devuelve los límites del plan y el uso actual del propietario. |
| GET | /recordings | Lista las grabaciones del propietario. Admite paginación y búsqueda. |
| GET | /recordings/{id} | Devuelve una grabación, incluida su transcripción y sus artefactos. |
| GET | /thought-threads | Lista los hilos de pensamiento del propietario. |
| GET | /thought-threads/{id} | Devuelve un hilo de pensamiento con sus elementos y fuentes de contexto. |
| GET | /folders | Lista las carpetas del propietario. |
| GET | /knowledge-bases | Lista las bases de conocimiento del propietario. |
La transcripción acepta un archivo de audio en el campo multipart audio o un campo JSON audio_base64, de hasta 500 MB. La conversión devuelve Markdown de forma predeterminada; pasa outputFormat: "plain" para texto sin formato.
Solicitud de ejemplo:
curl -X POST https://proset.ai/api/v1/transcribe \
-H "Authorization: Bearer proset_..." \
Herramientas de MCP
| Herramienta | Propósito |
|---|---|
transcribe | Transcribe audio en base64. |
convert | Convierte una transcripción en un artefacto. |
list_recordings | Lista las grabaciones. |
get_recording | Obtiene una grabación con su transcripción y sus artefactos. |
list_thought_threads | Lista los hilos de pensamiento. |
get_thought_thread | Obtiene un hilo de pensamiento con sus elementos y contextos. |
list_folders | Lista las carpetas. |
get_usage | Devuelve el plan y los límites de uso. |
Límites y medición
- La transcripción y la conversión cuentan contra la asignación del plan del propietario de la clave, igual que el uso dentro de la app.
- Proset no factura automáticamente el uso adicional. Cuando los Créditos de IA llegan a cero, las solicitudes se detienen hasta el reinicio mensual o hasta que haya más créditos prepagados disponibles.
- Las solicitudes de IA están limitadas a 10 por minuto por usuario.
- Todos los endpoints devuelven datos únicamente del propietario de la clave. No hay acceso a los datos de otra persona.
Códigos de error
| Código | Significado |
|---|---|
missing_api_key | No se proporcionó ninguna clave de API. |
invalid_api_key | La clave es inválida, desconocida o fue revocada. |
expired_api_key | La clave superó su caducidad. |
missing_audio | Se solicitó una transcripción sin un archivo de audio. |
insufficient_tokens | No quedan Créditos de IA mensuales ni prepagados. No se hace ningún cargo automático. |
spending_cap_reached | Se alcanzó el límite de gasto mensual de la cuenta. |
conversion_failed | No se pudo completar la conversión. |
Para los pasos de conexión, consulta Conecta Proset a un asistente de IA. Para una primera solicitud guiada, sigue Crea tu primera solicitud a la API de Proset, o lee Por qué usar la API para desarrolladores y el servidor MCP para ver el panorama completo.