Skip to main content

OpenAI Text-to-Speech

Generate natural-sounding speech from text using OpenAI's text-to-speech models.

Supported Models​

  • tts-1: Standard quality, faster generation
  • tts-1-hd: High quality, slower generation

Parameters​

ParameterTypeRequiredDescription
textstringYesText to convert to speech (max 4096 characters)
voicestringYesVoice to use for speech generation
response_formatstringNoAudio format (default: mp3)
speednumberNoSpeech speed (0.25 to 4.0, default: 1.0)

Voice Options​

  • alloy - Neutral, balanced voice
  • echo - Clear, expressive voice
  • fable - Warm, engaging voice
  • onyx - Deep, authoritative voice
  • nova - Bright, energetic voice
  • shimmer - Gentle, soothing voice

Response Format Options​

  • mp3 - MP3 audio format (default)
  • opus - Opus audio format
  • aac - AAC audio format
  • flac - FLAC audio format
  • wav - WAV audio format
  • pcm - PCM audio format

Request Example​

API Playground

https://api.1min.ai/api/features

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "TEXT_TO_SPEECH",
  "model": "tts-1",
  "conversationId": "TEXT_TO_SPEECH",
  "promptObject": {
    "text": "Hello, this is a sample text to speech conversion using OpenAI.",
    "voice": "alloy",
    "response_format": "mp3",
    "speed": 1
  }
}'

Response Format​

The API returns an audio file in the specified format. The response will be a binary audio stream.

{
  "aiRecord": {
    "uuid": "df33ba69-599a-4bb7-957b-98df4bf2aed4",
    "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
    "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
    "teamUser": {
      "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
      "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
      "userName": "Dương Nguyễn",
      "userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
      "status": "ACTIVE",
      "role": "ADMIN",
      "creditLimit": 100000000,
      "usedCredit": 1105408,
      "createdAt": "2025-10-20T04:13:40.847Z",
      "createdBy": "SYSTEM",
      "updatedAt": "2025-10-21T10:49:09.448Z",
      "updatedBy": "SYSTEM"
    },
    "model": "tts-1",
    "type": "TEXT_TO_SPEECH",
    "metadata": null,
    "rating": null,
    "feedback": null,
    "conversationId": null,
    "status": "SUCCESS",
    "createdAt": "2025-10-21T10:51:49.693Z",
    "aiRecordDetail": {
      "promptObject": {
        "text": "Hello, this is a sample text to speech conversion using OpenAI.",
        "speed": 1,
        "voice": "alloy",
        "response_format": "mp3"
      },
      "resultObject": [
        "development/audios/2025_10_21_17_51_52_314_169846.mp3"
      ],
      "responseObject": {}
    },
    "additionalData": null,
    "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/audios/2025_10_21_17_51_52_314_169846.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251021%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251021T105155Z&X-Amz-Expires=604800&X-Amz-Signature=ce1b6b3e40583fed39be021a56c66da4c3244a68605409bd835af2c4ea218785&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
  }
}