Ghost plugin

Automatically create and embed audio versions of Ghost posts.

This guide explains how to connect your Ghost site to SpeechKit using the SpeechKit x Ghost integration.

This allows you to automatically create and embed audio versions of your posts.

1. Set up the custom integration

  1. Log into your Ghost admin dashboard

  2. From the left-hand menu, select 'Integrations'

  3. Select 'Add custom integration'

  1. Enter the name 'SpeechKit' then select 'Create'
  1. Keep the admin API key and API URL on hand for later

2. Create a Ghost project on SpeechKit

  1. Sign into your SpeechKit account (don't have one? Start your free trial)

  2. Go to the 'Content' section of your project dashboard (don't have one? Create a project)

    Already created audio? You will need to navigate to 'Settings (Integration)' instead.

  3. Select 'Ghost' under 'Connect your CMS'

  1. Select the AI voices you would like to use for titles and body content (please note that this will also change the default voices for the API and Text-to-Speech Editor)
  1. Copy and paste the admin API key and API URL from Ghost into the corresponding fields, then select 'Test' — you should get a 'Success' message

  2. Copy the audio player script for use in the next stage

  1. Select 'Save changes'

3. Insert the audio player script

  1. Go to 'Settings' in your Ghost admin
  1. Select 'Code injection'
  1. Paste the audio player script into a new line in 'Site Footer' then select 'Save'

    Please note: While the audio player script is inserted into the Site Footer section, the automatic Player will be embedded at the top of your audio-enabled posts.

The SpeechKit x Ghost integration should now be installed, activated, and enabled. SpeechKit will automatically create audio versions of new posts, with each conversion using one audio credit. Once processed (this should take just a few minutes), the audio version will be automatically embedded into the source page.

FAQs

Will my old posts be converted into audio?

SpeechKit will not automatically convert pre-existing Ghost posts into audio. However, you can trigger audio processing by updating an old post.

You can also manually convert old posts into audio using the SpeechKit Editor and then embed the manual Player via iFrame.


What happens when I update a post?

If you update the text in an audio-enabled post via Ghost, SpeechKit will automatically reprocess the audio. Once available, the new version will be streamed in the Player. Reprocessing usually takes just a few minutes and will not use any additional audio credits.

If you update the text in an old page or post that does not currently have audio, this will trigger audio processing. This will use an audio credit and the Player will be embedded like normal.

You can check the status of any audio in the 'Content' section of your project dashboard.


Can I customize the Player's appearance?

Yes, you can customize the automatic Player used by the Ghost integration. See our guide on customizing the automatic Player.


Can I remove the automatic Player from specific posts?

Yes, you can remove the automatic Player from specific Ghost posts by disabling the corresponding audio. However, please note that this will affect all distributions of this audio.


Can I disable the automatic Player?

Yes, you can temporarily or permanently disable the automatic Player used by the Ghost integration. See our guide here.


Will the integration slow down my website?

Our Ghost integration should not slow down your website. We’ve designed SpeechKit to minimize any effect on latency. The JavaScript player is lightweight and embedded via an iFrame, which means that it only loads after all other page content has loaded. We’re also the only text-to-speech service that transcodes audio for HLS (HTTP Live Streaming), which splits audio into 15-second segments at different bit rates to ensure frictionless listening.”


Can I share my audio versions elsewhere?

Yes, there are many other ways to distribute audio versions of your Ghost posts.

All of your audio versions will be available in the 'Content (Audios)' section of your project dashboard, where you can:

You can also distribute your audio content via podcast feed or share a 'latest audio' playlist.



What’s Next