Documentación de la API, MeetingBrief

API sí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.

Sube una grabación de reunión y recibe en la misma respuesta HTTP una transcripción, un resumen ejecutivo, un registro de acciones y un borrador de correo de seguimiento.

Punto de acceso: POST https://mxprocess.com/api/files/start-process
Autenticación: Bearer JWT obtenido de POST /api/login_check
Coste: 480 tokens por ejecución correcta.

Solicitud

La solicitud debe ser multipart/form-data. El campo parameters es una cadena JSON, no un objeto multipart anidado.

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=false'

Archivos aceptados: MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV y AVI. Solo se acepta una grabación. language, audience y focus son opcionales; los valores predeterminados son francés, equipo del proyecto y decisiones/acciones/riesgos/preguntas abiertas.

Usa el modo síncrono solo cuando tu cliente HTTP pueda esperar a la transcripción y el análisis. Para grabaciones largas, usa la API asíncrona.

Respuesta correcta

El campo output contiene el resumen estructurado y downloadResults. Para mantener la compatibilidad con el endpoint síncrono existente, la solicitud persistida se serializa bajo la "0" clave; usa 0.id para descargar archivos mediante el endpoint autenticado siguiente.

{
  "output": {
    "brief": {
      "title": "Weekly project review",
      "executive_summary": "...",
      "decisions": [{"decision": "...", "evidence": "..."}],
      "action_items": [{"task": "...", "owner": "", "due_date": "", "priority": "high", "evidence": "..."}],
      "risks": [],
      "open_questions": [],
      "follow_up_email": {"subject": "...", "body": "..."}
    },
    "downloadResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  },
  "0": {
    "id": 123,
    "accomplished": true,
    "actionResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  }
}

Descargar un entregable

Sustituye ACTION_ID por el ID de acción devuelto y usa el nombre exacto del archivo de downloadResults.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/ACTION_ID/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."
}

Contáctenos