API asíncrona: resumen de reuniones con IA

Se necesita una cuenta gratuita antes de usar esta API. Crea y valida tu cuenta en /es/create-account, y obtén después tu token JWT con tus credenciales.

Usa este modo para grabaciones de reuniones de cualquier duración. La API crea la acción de inmediato y el trabajador produce en segundo plano la transcripción, el informe Markdown y el JSON estructurado.

Punto de acceso: POST https://mxprocess.com/api/files/start-process
Autenticación: Bearer JWT desde POST /api/login_check
Coste: 480 tokens, se cobran solo después de un procesamiento correcto.

1. Iniciar la acción

Envía un archivo de audio o vídeo como multipart/form-data. El valor de parameters debe ser una cadena JSON.

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --header 'Accept: application/json' \ --form 'file=@"/absolute/path/weekly-review.mp4"' \ --form 'actionName=MeetingBrief' \ --form 'parameters=[["language",["French"]],["audience",["project team"]],["focus",["decisions, actions, risks and open questions"]]]' \ --form 'async=true'

Aceptado: MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV y AVI. Se requiere exactamente una grabación. Los parámetros opcionales tienen como valores predeterminados francés, equipo del proyecto y decisiones/acciones/riesgos/preguntas abiertas.

2. Respuesta inicial

Conserva el id o la trackingUrl; en esta etapa la grabación solo se ha puesto en cola.

{ "id": 123, "actionParameters": [["language", ["French"]]], "hostedFileIds": [{"fileId": 456, "parameters": ""}], "action": {"actionName": "MeetingBrief", "slug": "ai-meeting-brief"}, "accomplished": false, "actionResults": [], "priceInTokensAtTimeOfUse": 18, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/123" }

3. Consultar el estado

Consulta cada 10–15 segundos hasta que accomplished se convierta en true. No vuelvas a enviar la grabación original durante el procesamiento.

curl --location --request GET 'https://mxprocess.com/api/actions/get-action-infos/123' \ --header 'Authorization: Bearer YOUR_TOKEN' { "id": 123, "accomplished": true, "actionResults": [ ["weekly-review-transcript.txt", "https://..."], ["weekly-review-meeting-brief.md", "https://..."], ["weekly-review-meeting-brief.json", "https://..."] ], "priceInTokensAtTimeOfUse": 18 }

4. Descargar un resultado

Usa el nombre exacto del archivo de actionResults. El endpoint autenticado funciona tanto si el almacenamiento de objetos está habilitado como si no.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/123/weekly-review-meeting-brief.json' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --output weekly-review-meeting-brief.json

Ejemplo de error funcional

{ "error": "ERROR_MB004 MeetingBrief accepts audio or video recordings only." }

¿Necesitas una respuesta inmediata? Usa la API síncrona para grabaciones cortas.

Contáctenos