---
title: "POST AI Generate summary"
method: POST
path: "/api/files/ai/generate-summary"
---

# POST AI Generate summary

`POST /api/files/ai/generate-summary`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/files/ai/generate-summary`
- Auth: API key in header `Authorization`

Gera um **resumo** do documento com o Astro e o salva no documento.

*   Com `audio: false`, a resposta traz o resumo em `message` (HTML simples).
*   Com `audio: true`, a API também converte o resumo em áudio (MP3) e responde com `audio` (URL de `POST /api/files/ai/audio/{document_key}` para baixá-lo). Nesse caso `message` traz o resultado da geração do áudio (`true`/`false`), não o texto; o resumo fica salvo no documento.
*   Se não for possível extrair o texto do documento, `message` vem como `false`.

## Request body

- object
  - `provider` 'openai', required: Provedor de IA. Único valor aceito: openai.
  - `model` 'gpt-4o-mini', required: Modelo. Único valor aceito: gpt-4o-mini.
  - `document_key` string, required: Document Key de um documento da sua empresa.
  - `audio` boolean, required: true para também gerar o áudio (MP3) do resumo.

## Response `200`

Resumo gerado

- object
  - `message` string: Resumo em HTML simples (audio: false) ou resultado true/false da geração do áudio (audio: true).
  - `audio` string: URL para baixar o MP3 (apenas com audio: true).

## Other responses

- `403`: IA não habilitada para o usuário do token
- `422`: Erro de validação
- `500`: Falha ao obter a resposta do assistente ou ao gerar o áudio

## Changes

- **2026-11-03** `3db1513040ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/files/ai/generate-summary/post.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)