πŸ“– Document Overview

Target Audience: Enterprise developers, product managers, technical architects

Document Purpose: This document provides a complete integration guide for the ListenHub audio generation service, including quick start, core concepts, API usage, and error handling.

Technical Support: If you have any questions, please contact the ListenHub technical team at [email protected]


πŸš€ I. Quick Start (5-Minute Guide)

1. Prerequisites

Plan Requirements:

Get API Key:

  1. Visit API Keys Settings Page
  2. Click β€œCreate API Key”
  3. Copy and securely store your API Key

2. First API Call

2.1 Verify API Key

Test if your API connection is working:

curl -X GET "<https://api.marswave.ai/openapi/v1/speakers/list?language=en>" \\
  -H "Authorization: Bearer YOUR_API_KEY"

Successful Response Example:

{
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "name": "Mars",
        "speakerId": "cozy-man-english",
        "demoAudioUrl": "<https://marswave-podcast-production.s3.us-west-2.amazonaws.com/audios/mars-cozy-man-english.mp3>",
        "gender": "male",
        "language": "en"
      },
      {
        "name": "Mia",
        "speakerId": "travel-girl-english",
        "demoAudioUrl": "<https://marswave-podcast-production.s3.us-west-2.amazonaws.com/audios/mars-travel-girl-english.mp3>",
        "gender": "female",
        "language": "en"
      }
    ]
  }
}

2.2 Create Your First Podcast