Podfeed n8n Node

A custom n8n community node for integrating with the Podfeed API to generate podcast-style audio content using AI.

Installation

To install this node in your n8n instance:

1. Install the package:

   npm install n8n-nodes-podfeed
   

2. Restart your n8n instance.

Configuration

Credentials

To use this node, you need to configure your Podfeed API credentials:

1. In n8n, go to Settings → Credentials
2. Create new credentials of type Podfeed API
3. Enter your API key (get it from podfeed.ai)
4. Optionally, set a custom Base URL (default: https://api.podfeed.ai)

Features

This node supports all major Podfeed API operations:

Operations

• Generate Audio: Create podcast-style audio from various input types
• Get Task Status: Check the status of an audio generation task
• Wait for Completion: Poll for task completion with configurable timeout
• Get Audio: Get details for a specific audio file
• List Available Voices: Get all available voices organized by language

Input Types

The Generate Audio operation supports 5 different input types:

1. Text: Direct text input for immediate audio generation
2. URL: Website URL to scrape and convert to audio
3. Topic: Research-based generation from a topic description
4. Script: Bring-your-own-script for direct text-to-speech
5. File: File upload (supports PDFs, documents, audio files, etc.)

Audio Modes

• Monologue: Single voice narration
• Dialogue: Two-voice conversation with host and co-host

Voice Configuration

• Support for multiple voice providers (Google, ElevenLabs, Gemini)
• Custom voice instructions for personalized speech styles
• Separate voice configuration for dialogue mode (host + co-host)

Content Configuration

• Complexity levels: Beginner, Intermediate, Expert
• Length options: Short, Medium, Long
• Language support: Multiple languages (default: en-US)
• Additional options: Emphasis, Q&A segments, custom instructions
• Read mode: Direct text reading for script input type

Usage Examples

Simple Text-to-Audio

1. Select Generate Audio operation
2. Choose Text input type
3. Enter your text content
4. Select Monologue mode
5. Choose a voice (e.g., "gemini-puck")
6. Configure content settings
7. Execute the node

Website-to-Podcast

1. Select Generate Audio operation
2. Choose URL input type
3. Enter the website URL
4. Select Dialogue mode for conversation-style output
5. Choose host and co-host voices
6. Add custom instructions in Additional Fields
7. Execute the node

Task Monitoring

1. Use Generate Audio to start the process
2. Get the task_id from the response
3. Use Wait for Completion with the task ID
4. Configure timeout and poll interval
5. Get the final result with audio URL

API Compatibility

This node implements the full Podfeed API functionality, equivalent to the Python SDK.

Support

For issues with this n8n node, please report them on the GitHub repository.

For Podfeed API support, contact: support@podfeed.ai

License

MIT