---
title: "Generate AI summary"
method: POST
path: "/summaries"
tags: ["Summaries"]
---

# Generate AI summary

`POST /summaries`

## Request

- Base URL: `https://studio.fintechstudios.com/api/v1`
- URL: `https://studio.fintechstudios.com/api/v1/summaries`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Search for articles and generate an executive-level AI summary with inline citations. Credits are charged dynamically based on the FTS search cost plus LLM token usage.

## Request body

- object
  - `query` string, required
  - `model` string
  - `max_tokens` integer
  - `language` string
  - `citation_format` 'inline' | 'none'

## Response `200`

Generated summary

- object
  - `data` object
    - `query` string
    - `summary` string
    - `articles_found` integer
    - `model` string
    - `sources` Article[]
      - `id` string
      - `title` string
      - `summary` string
      - `source` string
      - `url` string, nullable
      - `published_at` string, date-time
      - `image_url` string, nullable: Article image URL if available
      - `sentiment` 'positive' | 'negative' | 'neutral'
  - `meta` Meta
    - `request_id` string
    - `credits_used` integer
    - `credits_remaining` integer
    - `rate_limit` object
      - `limit` integer
      - `remaining` integer
      - `reset` integer

---

[API](https://skmtc.dev/fintechstudios/apis/fts-studio-api.md) · [All operations](https://skmtc.dev/fintechstudios/apis/fts-studio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintechstudios/apis/fts-studio-api/revisions/4886597d1d96?raw)