CreoleCentric Logo
CreoleCentric Logo
Sign In

API Changelog

API Contract Version v1.0.0

This changelog tracks API contract changes, breaking changes, new endpoints, and deprecations. For application feature updates, see the App Changelog.

Production:api.creolecentric.com/v1
Status:operational

v1.0.1

✓ Stable

Granular Pause Controls & Enhanced Voice Settings

October 14, 2025

Added 8 new granular pause control parameters and enhanced voice customization options. Deprecated legacy pause parameters with full backward compatibility.

Features

  • CHANGEDAutomatic parameter mapping: Legacy pause parameters now map to new granular controls
  • CHANGEDFull backward compatibility: All existing API integrations continue to work without changes

Parameters

  • NEWcomma_pause_ms - Precise pause duration after commas (default: 250ms)
  • NEWsemicolon_pause_ms - Precise pause duration after semicolons (default: 300ms)
  • NEWcolon_pause_ms - Precise pause duration after colons (default: 350ms)
  • NEWperiod_pause_ms - Precise pause duration after periods (default: 500ms)
  • NEWexclamation_pause_ms - Precise pause duration after exclamation marks (default: 550ms)
  • NEWquestion_pause_ms - Precise pause duration after question marks (default: 600ms)
  • NEWellipsis_pause_ms - Precise pause duration after ellipsis (default: 700ms)
  • NEWparagraph_pause_ms - Precise pause duration between paragraphs (default: 800ms)
  • NEWstability - Voice stability control (0.0-1.0, controls expressiveness vs consistency)
  • NEWsimilarity_boost - Voice similarity boost (0.0-1.0, controls adherence to original voice)
  • NEWstyle - Style strength/exaggeration (0.0-1.0, controls speaking style intensity)
  • NEWuse_speaker_boost - Enable speaker boost for improved clarity (boolean, default: true)

Deprecations

  • DEPRECATEDphrase_pause_ms - Replaced by comma_pause_ms and semicolon_pause_ms for granular control
  • DEPRECATEDsentence_pause_ms - Replaced by period_pause_ms, exclamation_pause_ms, and question_pause_ms

v1.0.0

✓ Stable

Initial API Release

October 12, 2025

First stable release of the CreoleCentric REST API with comprehensive TTS capabilities.

Endpoints

  • NEWPOST /v1/tts/submit/ - Submit text-to-speech jobs
  • NEWGET /v1/tts/jobs/ - List TTS job history
  • NEWGET /v1/tts/jobs/{id}/ - Get specific job details
  • NEWGET /v1/voices/ - List available voices
  • NEWGET /v1/credits/balance/ - Get credit balance
  • NEWGET /v1/users/status/ - Get API status and version

Authentication

  • NEWJWT Bearer token authentication
  • NEWAPI key support for server-to-server calls

Features

  • NEWWebhook notifications for job status updates
  • NEWSupport for multiple audio formats (MP3, WAV, OGG)
  • NEWVoice parameter customization (speed, pitch, stability)

Rate Limits

  • NEWPlan-based rate limiting: Free (10/min), Creator (30/min), Pro (60/min), Business (120/min)

Stay Informed About API Changes

Critical API changes are communicated through multiple channels:

Email Notifications
Sent to all API key holders for breaking changes
Response Headers
Sunset and Deprecation headers
Version Lifecycle Policy
7-month migration window for all breaking changes
API Documentation
Always reflects current stable version
← Back to Developer Portal