> ## Documentation Index
> Fetch the complete documentation index at: https://docs.easy-peasy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate Audio Content

> Generate AI-powered content from a completed transcription. Produces summaries, titles, action items, and more depending on the audio type.

**Content generated by audio type:**
- **Meeting**: summary, title, description, action items, keywords, timestamped overview, topics & bullets, LinkedIn post
- **Podcast**: summary, title, description, show notes, Twitter thread, article, newsletter, keywords, questions, LinkedIn post, timestamped overview, topics & bullets
- **Therapy Session**: summary, title, description, progress note, SOAP note, DAP note, keywords, timestamped overview, topics & bullets, LinkedIn post

You can generate all fields at once or specify individual fields with the `fields` parameter.



## OpenAPI

````yaml POST /api/generate-audio-content
openapi: 3.0.1
info:
  title: Easy-Peasy.AI API
  description: >-
    OpenAPI Specifications for the Easy-Peasy.AI API.


    All API requests must be authenticated with an API key. Include the
    `x-api-key` API key in the request header with all requests. You can get the
    API key [here](https://easy-peasy.ai/settings/api).
  version: 1.0.4
servers:
  - url: https://easy-peasy.ai
security:
  - apiKeyAuth: []
paths:
  /api/generate-audio-content:
    post:
      summary: Generate Audio Content
      description: >-
        Generate AI-powered content from a completed transcription. Produces
        summaries, titles, action items, and more depending on the audio type.


        **Content generated by audio type:**

        - **Meeting**: summary, title, description, action items, keywords,
        timestamped overview, topics & bullets, LinkedIn post

        - **Podcast**: summary, title, description, show notes, Twitter thread,
        article, newsletter, keywords, questions, LinkedIn post, timestamped
        overview, topics & bullets

        - **Therapy Session**: summary, title, description, progress note, SOAP
        note, DAP note, keywords, timestamped overview, topics & bullets,
        LinkedIn post


        You can generate all fields at once or specify individual fields with
        the `fields` parameter.
      operationId: generateAudioContent
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
          description: Your API key
          example: 27feb2bb-aeb4-4a83-9fb6-8f3f2a15885e
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateAudioContentRequest'
            examples:
              all_fields:
                summary: Generate all content
                value:
                  audio_id: 4bc4e8ee-f29e-4a53-996e-5da955c42927
              specific_fields:
                summary: Generate specific fields only
                value:
                  audio_id: 4bc4e8ee-f29e-4a53-996e-5da955c42927
                  fields:
                    - summary
                    - title
                    - keywords
              force_regenerate:
                summary: Force regenerate existing content
                value:
                  audio_id: 4bc4e8ee-f29e-4a53-996e-5da955c42927
                  fields:
                    - summary
                  force: true
      responses:
        '200':
          description: Successfully generated content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerateAudioContentResponse'
              example:
                success: true
                data:
                  summary: >-
                    The team discussed Q1 progress, reviewed the product
                    roadmap, and assigned action items for the upcoming sprint.
                  title: Q1 Review & Sprint Planning Meeting
                  keywords: Q1 review, sprint planning, product roadmap, action items
                  action_items: |-
                    1. John to finalize the design mockups by Friday
                    2. Sarah to update the project timeline
                    3. Team to review the new feature spec
        '400':
          description: Bad request — audio not yet transcribed or invalid fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Audio has not been transcribed yet
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invalid API key
components:
  schemas:
    GenerateAudioContentRequest:
      type: object
      required:
        - audio_id
      properties:
        audio_id:
          type: string
          description: The UUID of the audio transcription
          example: 4bc4e8ee-f29e-4a53-996e-5da955c42927
        fields:
          type: array
          items:
            type: string
            enum:
              - summary
              - title
              - description
              - keywords
              - action_items
              - show_notes
              - twitterThread
              - article
              - newsletter
              - questions
              - linkedin_post
              - timestamped_overview
              - topics_and_bullets
              - progress_note
              - soap_note
              - dap_note
          description: >-
            Specific fields to generate. If omitted, all fields appropriate for
            the audio type are generated.
        force:
          type: boolean
          default: false
          description: If true, regenerate content even if it already exists.
    GenerateAudioContentResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Whether content was generated successfully
        data:
          type: object
          description: >-
            Object containing the generated content fields. Keys depend on the
            audio type and requested fields.
          additionalProperties:
            type: string
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
          example: Invalid API key
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Get yours at
        https://easy-peasy.ai/settings/api

````