API Documentation

Integrate Melvo Pro into your applications

API Key

⚠️ Keep your API key secret. Never expose it in client-side code or public repositories.

BASE URL

https://api.melvo.pro/v1

Generate Speech (ElevenLabs)

POST

/tts/generate

Request

{
  "text": "Hello, this is a test message",
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "model_id": "eleven_flash_v2_5"
}

Response

{
  "success": true,
  "job_id": "uuid-here",
  "task_id": "uuid-here",
  "cost": 27,
  "message": "TTS generation started"
}

Code Examples

curl -X POST https://api.melvo.pro/v1/tts/generate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, this is a test",
    "voice_id": "21m00Tcm4TlvDq8ikWAM",
    "model_id": "eleven_flash_v2_5"
  }'

Generate Speech (Melvo)

POST

/tts/melvo/generate

Request

{
  "text": "Hello from Melvo engine",
  "voice_id": "209533299589184",
  "model": "speech-2.5-hd-preview",
  "settings": {
    "speed": 1.0,
    "pitch": 0,
    "volume": 1.0
  }
}

Response

{
  "success": true,
  "job_id": "uuid-here",
  "task_id": "uuid-here",
  "cost": 26,
  "message": "TTS generation started"
}

Code Examples

curl -X POST https://api.melvo.pro/v1/tts/melvo/generate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from Melvo",
    "voice_id": "209533299589184",
    "model": "speech-2.5-hd-preview",
    "settings": {"speed": 1.0, "pitch": 0, "volume": 1.0}
  }'

Get Task Status

GET

/task/:task_id

Request

curl https://api.melvo.pro/v1/task/your-job-id \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "success": true,
  "task_id": "uuid",
  "status": "succeeded",
  "audio_url": "https://cdn.melvo.pro/audio/...",
  "created_at": "2025-10-17T00:00:00Z",
  "completed_at": "2025-10-17T00:00:05Z",
  "cost": 27
}