AXIAL Audio Post Narration

AXIAL Audio Post Narration connects WordPress to the AXIAL Nebula Audio service and lets editors generate audio for already-published content.

The plugin supports two audio modes, selected in the Nebula API configuration:

• Audio summary: Nebula prepares a shorter spoken version of the post.
• Full reading: Nebula prepares the complete article for natural narration without intentionally summarizing it.

Enable optional dual-player mode to generate and display both audio modes on one post, each using its own configured API. Choose each player placement independently (before/after content, floating bottom bar, or shortcode), with 1x / 1.2x / 1.5x playback speeds (1.2x default). The original single-player interface remains available when dual mode is disabled.

The generated audio can be downloaded into the WordPress Media Library and displayed with an accessible audio player.

Features include:

• Optional dual playback: separate summary and full-article MP3s for the same post.
• Independent API and placement settings for each player.

• Shortcodes [nebula_audio_resumen] and [nebula_audio_completo] for manual placement.

• Configure multiple Nebula Audio APIs, each with its own identifiable name.

• Select which API to use from each post editor; different APIs can use different voices or audio rules.
• Choose one default API for automatic generation, bulk actions, and batch generation.
• Estimate the credits required for a post with its selected Audio API before generating audio.
• Generate audio from existing published posts.
• Optional automatic generation when a post is published.
• Generate audio for multiple existing posts.
• Local validation to avoid sending posts that contain no useful editorial text.
• Optional local MP3 copy in the Media Library.
• Accessible floating player with play/pause, duration, and 1x / 1.2x / 1.5x playback speeds on standard pages; default speed is 1.2x, with visitor preference preserved.
• AMP-compatible playback using native amp-audio actions (Play/Pause) without custom JavaScript.
• Configurable player accent, background, and text colors.
• Placement before content, after content, as a floating player, or through the [nebula_audio] shortcode.
• Background status polling for asynchronous Nebula jobs.
• Manual “Check status now” action from the post editor.

An AXIAL Nebula account, a Nebula Audio API key, and available service credits are required for audio generation. The WordPress plugin itself does not contain a paid-code unlock or local feature trial; charges apply to the external Nebula service.

Create an AXIAL account:
https://axial.ar/es/register/

AXIAL website:
https://axial.ar/

External service

This plugin depends on the external AXIAL Nebula Audio service to generate audio.

Service endpoint used by the plugin:
https://axial.ar/apis/v1/audio-management

When an authorized editor requests audio generation, the plugin sends the following data to AXIAL Nebula:

• The configured AXIAL/Nebula account email.
• The configured Nebula API key in the Authorization header.
• The WordPress post title.
• The WordPress post content.
• The post excerpt when the configured API uses Audio summary mode.
• A request identifier used to avoid duplicate generation requests.
• The site URL as part of the HTTP User-Agent string.

This data is sent only when the plugin needs to query API capabilities, estimate/generate audio, or retrieve the result of a previously requested job. If local audio storage is enabled, the plugin also downloads the generated audio URL returned by Nebula into the WordPress Media Library.

The external service may consume paid credits according to the user’s AXIAL/Nebula account and API configuration.

Service provider:
https://axial.ar/

Privacy policy:
https://axial.ar/politica-de-privacidad/

Privacy

The plugin itself does not add advertising or tracking scripts. It communicates with AXIAL Nebula only as required to authenticate, generate audio, check asynchronous job status, and retrieve generated audio. See the External service section for the exact data transmitted.

The plugin also adds suggested disclosure text to WordPress Settings > Privacy so site owners can include the integration in their own privacy policy when appropriate.

1. Upload the plugin folder to /wp-content/plugins/ or install the ZIP from Plugins > Add New > Upload Plugin.
2. Activate AXIAL Audio Post Narration.
3. Create or use an AXIAL Nebula account.
4. Create one or more APIs of type Audio in AXIAL Nebula. Each API may use a different audio mode, voice, or editorial rules.
5. Copy each API key when it is created.
6. In WordPress, open AXIAL Audio.
7. Add each API with an identifiable name, account email, and API key.
8. Choose the default API and use Test on each connection. Testing saves the current form before contacting Nebula.
9. Configure post types and player behavior.
10. Open a published post, choose the desired API, and click Calcular créditos to estimate the cost.
11. Click Generate audio when you are ready.

1. 

   Main plugin settings and API connections in WordPress.

2. 

   Generate audio narration directly from a WordPress post.

3. 

   Audio player displayed on desktop.

4. 

   Audio player displayed on mobile devices.

5. 

   Create your AXIAL account and receive 25 free trial credits.

6. 

   Generate a new API key from your AXIAL account.

7. 

   Copy and securely store your API key.

8. 

   Access and manage your APIs from the AXIAL dashboard.

9. 

   Open the API configuration settings.

10. 

    Select Audio as the API type.

11. 

    Configure narration mode, voice, duration, and text rules.

12. 

    Connect your AXIAL API to the WordPress plugin.

13. 

    Recharge credits and access help documentation.

1.2.3

• Add optional dual-player mode with separate summary and full-text APIs, generation jobs, and MP3 records per post.
• Add independent player placement settings: before content, after content, floating bottom bar, or shortcode.
• Add [nebula_audio_resumen] and [nebula_audio_completo] shortcodes.
• Support playback speeds 1x, 1.2x (default), and 1.5x in inline and floating players.
• Preserve previously generated audio when enabling dual mode.
• Hide legacy Audio · Nebula editor panel in dual mode; retain the original interface when dual mode is disabled.

1.1.2

• Added on-demand per-post credit estimation for the selected Audio API using the AXIAL estimate command.
• Playback defaults to 1.2x for visitors without a saved preference; 1x and 1.5x remain available.

1.1.1

• Added the ability to upload or select an existing MP3 and associate it with a post.
• Added a direct Download MP3 button in the post editor.
• Manually associated audio is tracked separately from Nebula-generated audio and prevents stale polling from overwriting it.

1.1.0

• Added support for multiple Nebula Audio APIs on the same WordPress site.
• Added an identifiable name for each API connection.
• Added per-post API selection before generating or regenerating audio.
• The selected API is stored with the post/job so status polling uses the same credentials.
• Added a default API for automatic generation, bulk actions, and batch generation.
• Existing single-API settings are migrated automatically to an “API principal” connection.

1.0.1

• Added AMP-compatible audio playback using amp-audio and native AMP Play/Pause actions.
• Custom frontend JavaScript is no longer enqueued on AMP requests.
• Standard pages keep the existing player and 1x / 1.2x / 1.5x speed controls.

1.0.0

• Initial WordPress.org submission candidate under the AXIAL Audio Post Narration name.
• Audio summary and Full reading support.
• Accessible floating player with configurable colors and playback speed.
• Manual generation sends the initial request to Nebula immediately.
• Background polling and batch generation support.
• Existing Nebula Audio Client settings and post metadata remain compatible.
• Added external-service and privacy disclosures.