---
title: "POST AI Summary audio"
method: POST
path: "/api/files/ai/audio/{document_key}"
---

# POST AI Summary audio

`POST /api/files/ai/audio/{document_key}`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/files/ai/audio/{document_key}`
- Auth: API key in header `Authorization`

Baixa o **áudio (MP3) do resumo** gerado por `POST /api/files/ai/generate-summary` com `audio: true`.

*   A `document_key` pode ir no caminho (`/api/files/ai/audio/{document_key}`) ou, omitindo o último segmento, no corpo da requisição.
*   A resposta é o arquivo MP3 (`Content-Disposition: attachment`).
*   Se o áudio ainda não foi gerado para o documento, a API responde erro interno (`500`).

## Path parameters

- `document_key` string, required

## Request body

- object
  - `document_key` string: Alternativa ao parâmetro de caminho (obrigatória quando o caminho não tem document_key).

## Response `200`

Arquivo MP3 (Content-Disposition: attachment)

## Other responses

- `403`: IA não habilitada para o usuário do token
- `404`: document_key do caminho inexistente ou de outra empresa
- `422`: document_key do corpo ausente ou inválida
- `500`: Áudio ainda não gerado para o documento

## Changes

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

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/files/ai/audio/:document_key/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)