Lahajati AI API Documentation

Introduction

Welcome to the Lahajati AI API documentation. Here you will find all the information you need to integrate our cutting-edge text-to-speech, speech-to-speech, and voice cloning technology into your applications.

Making Requests

Authentication

Lahajati AI API uses API keys to authenticate requests. You can obtain your API key from your account dashboard.

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Requests without authentication will fail with a `401 Unauthorized` status code.

Error Handling (General)

Lahajati AI API uses standard HTTP status codes to indicate the success or failure of an API request. In general: Codes in the `2xx` range indicate success. Codes in the `4xx` range indicate an error that failed given the information provided by the client (e.g., a required parameter was omitted, authentication failed, etc.). Codes in the `5xx` range indicate an error with our servers.

`400 Bad Request`: The server could not understand the request due to invalid syntax. Check your request body format or query parameters.
`401 Unauthorized`: Your API key is missing, invalid, or expired. Ensure you're including a valid `Authorization: Bearer YOUR_API_KEY` header.
`403 Forbidden`: You do not have permission to access this resource or perform this action (e.g., trying to modify a resource you don't own, or package limits exceeded).
`404 Not Found`: The requested resource could not be found (e.g., a non-existent `id_voice`).
`422 Unprocessable Entity`: The request was well-formed but was unable to be followed due to semantic errors (input validation failed). The response body will typically include an `errors` object with details on which fields failed validation.
`429 Too Many Requests`: You've exceeded the request rate limit (RPM) allowed for your subscription package. Try again later. See the Rate Limits section.
`500 Internal Server Error` / `502 Bad Gateway` / `503 Service Unavailable`: An unexpected error occurred on our server side, or the service is temporarily unavailable. If the problem persists, please contact support.

Rate Limits (RPM)

Lahajati AI API enforces limits on the number of requests you can make per minute (RPM) based on your subscription package. These limits are in place to ensure stable and fair performance for all users. Exceeding these limits will result in a `429 Too Many Requests` error response.

Package	Requests Per Minute (RPM)
Free Package	30
Starter Package	100
Content Creator Package	250
Premium Package	400
Business Package	500

Important Note: To request higher rpm limits for the Business package, please contact support at: support@lahajati.ai.

Concurrent Request Limits

In addition to RPM limits, there are restrictions on the number of concurrent requests your account can have running simultaneously. This helps maintain system stability.

Package	Max Concurrent Requests
Free Package	2
Starter Package	5
Content Creator Package	10
Premium Package	15
Business Package	20

Important Note: To request higher concurrency limits for the Business package, please contact support at: support@lahajati.ai.

POSTPOST Text To Speech Super

https://lahajati.ai/api/v1/text-to-speech-pro

Generates high-quality speech audio from the provided text using the specified voice model and parameters.

Request Body Parameters (JSON)

Parameter	Type	Required	Description
`text`	string	Yes	The text to be converted into speech.
`id_voice`	string	Yes	The unique identifier for the desired voice speaker. Obtainable via the Get Voices endpoint.
`privacy`	boolean (Boolean)	No (default `0`)	Set to `1` for more privacy (when set to 1, the transformation is treated as anonymous and the operation is never saved in our ruleset)
`professional_quality`	boolean	No (defaults to `0`)	Set to `1` to enable enhanced processing for professional-grade audio output.
`speech_speed`	float	No (defaults to `1.0`)	Controls the speed of the generated speech. Range: `0.8` to `1.3`.
`volume`	float	No (defaults to `1.0`)	Adjusts the volume of the generated speech. Range: `0.0` to `1.0`.

Success Response

On success (`200 OK`), the response body will contain the raw audio data. The `Content-Type` header will be `audio/mpeg`.

Error Responses

In addition to the general errors, you might encounter the following endpoint-specific errors:

400 Invalid input format or missing required parameters.
404 The specified `id_voice` does not exist.
422 Input validation failed. The response body will contain details.

POSTPOST Speech To Speech Pro

https://lahajati.ai/api/v1/speech-to-speech-pro

Converts an audio file into speech using another specified voice, preserving intonation and style, using the specified voice model and parameters.

Important Note: Requests to this endpoint must be sent using `multipart/form-data` due to the audio file upload.
Note: When using `FormData` in JavaScript or equivalent in other libraries, the browser/library automatically sets the `Content-Type: multipart/form-data` header with the correct `boundary`. Do not set it manually.

Request Parameters (Form Data)

Parameter	Type	Required	Description
`audio_file`	file (audio)	Yes	The audio file to convert. Supported types: `mp3, wav, aac, ogg`. Max size: 50MB.
`id_voice`	string	Yes	The unique identifier for the desired voice speaker. Obtainable via the Get Voices endpoint.
`professional_quality`	boolean	No (defaults to `0`)	Set to `1` to enable enhanced processing for professional-grade audio output.

Success Response

On success (`200 OK`), the response body will contain the raw converted audio data. The `Content-Type` header will be `audio/mpeg`.

Error Responses

In addition to the general errors, you might encounter the following endpoint-specific errors:

400 Invalid request, usually due to missing `audio_file` or incorrect `Content-Type`.
402 Insufficient points balance.
403 API key expired or insufficient permissions for the selected voice.
404 The specified `id_voice` does not exist.
422 Input validation failed. The response body will contain details.

GETGET Get Voices

https://lahajati.ai/api/v1/voices

Retrieves a list of available voices that can be used with the Text-to-Speech and Speech-to-Speech endpoints, including cloned voices.

Query Parameters

Optional parameters to filter, sort, and paginate the results.

Parameter	Type	Required	Description
`page`	integer	No (defaults to 1)	The page number of the results to retrieve.
`per_page`	integer	No (defaults to 15, max 100)	The number of voices to return per page.
`gender`	string	No	Filter by gender. Allowed values: `1` (Male), `2` (Female), `3` (Child).

Success Response (200 OK)

Returns a paginated list of voice objects matching the criteria.

Error Responses

In addition to the general errors, you might encounter the following endpoint-specific errors:

422 Query parameter validation failed. See `errors` object.

Voice Cloning Best Practices

To achieve the best results when using the voice cloning feature, providing high-quality audio samples is crucial. Below are guidelines and recommendations to help you prepare your audio files:

Audio Quality Guidelines

Single Speaker Only: Ensure the recording clearly contains the voice of only one person (no other voices or background music).
Consistent Performance: Maintain as consistent a volume, tone, and emotion as possible throughout the recording.
Natural Pauses: Include short, natural pauses between sentences (0.5s is recommended).
Quiet Environment: Record in a space as free from background noise and echo as possible.
Professional Quality (Ideal): If possible, use professional recording equipment (good microphone) and an acoustically treated environment (minimize room echo).

Ideal Audio Sample Characteristics

Recommended Duration: For optimal quality and performance versatility (e.g., ability to express different emotions), provide an audio sample longer than 60 seconds.
For Consistent Performance: If targeting a specific, consistent performance style (like news reading), a 30 to 50-second sample with clear audio and steady delivery may suffice.
Clarity and Purity: The audio sample must be completely free of noise and distortion (avoid audio clipping or distortion). Clear, clean audio is key.
Intelligent Training: Our AI system will analyze and train itself on the voice's accent, tone, and performance style (whether happy, energetic, formal, etc.) from the provided sample.

Supported File Formats

We accept a variety of audio file formats (as specified in the `audio_file` parameter for the Create Cloned Voice endpoint).

Recommendation: For a good balance between quality and file size, we recommend using MP3 format at a bitrate of 192kbps or higher. Uncompressed formats (like WAV) may offer minimal noticeable benefit compared to their increased file size and processing time.

POSTPOST Create Cloned Voice

https://lahajati.ai/api/v1/voices/cloned

Allows creating a new cloned voice by uploading a training audio file and providing necessary metadata. The cloned voice will be available for use in Text-to-Speech after processing is complete.

Important Note: Requests to this endpoint must be sent using `multipart/form-data`.
Note: When using `FormData` in JavaScript or equivalent in other libraries, the browser/library automatically sets the `Content-Type: multipart/form-data` header with the correct `boundary`. Do not set it manually.

Refer to the Voice Cloning Best Practices section for optimal results.

Request Parameters (Form Data)

Parameter	Type	Required	Description
`voice_name`	string	Yes	The name to give to the cloned voice. (Max: 25 characters).
`gender`	integer	Yes	Gender of the voice. Allowed values: `1` (Male), `2` (Female), `3` (Child).
`audio_file`	file (audio)	Yes	A single audio file for training the voice clone. Supported types: `mp3, wav, aac, ogg, flac, m4a`. Max size: 50MB. (Good quality, clear audio without background noise yields best results).
`enhance_audio`	boolean	No (defaults to `false`)	Set to `true` to enhance the quality of the training audio file before sending it to the cloning model (may increase processing time).
`voice_image`	file (image)	No	Image for the cloned voice. Supported types: `jpeg, png, jpg, gif, webp`. Max size: 2MB.
`voice_tags`	string	No	Optional comma-separated tags or categories for the cloned voice (e.g., "calm, formal"). (Max: 255 characters).
`preview_audio_sample`	file (audio)	No	Optional audio file as a sample to preview the cloned voice. Supported types: `mp3, wav`. Max size: 10MB. (Only available for certain user ranks).

Success Response (201 Created)

On successful creation, returns the details of the newly created cloned voice. The voice may take some time to become fully active.

Error Responses (Create Cloned Voice)

In addition to the general errors, you might encounter the following endpoint-specific errors:

403 Maximum cloned voice limit reached.
422 Input validation failed (e.g., missing name, invalid file type, file too large).
500 Error communicating with the external voice cloning service or processing failed there.

PUTPUT Update Cloned Voice

https://lahajati.ai/api/v1/voices/cloned/{id_voice}

Allows updating the metadata of an existing cloned voice (e.g., name, gender, image, tags). The original training audio cannot be changed.

Important Note: Note: Use `multipart/form-data` only if you are uploading a new `voice_image` file. Otherwise, data can be sent as `application/x-www-form-urlencoded` or `application/json`. If using `multipart/form-data`, do not manually set the `Content-Type` header in JavaScript or similar libraries.

Important Note: All parameters in the request body are optional. Only send those you wish to update.

Path Parameter

Parameter	Type	Required	Description
`{id_voice}`	string	Yes	The unique ID of the cloned voice to update (starts with `lvc_`). Passed as part of the URL.

Optional Request Parameters (Form Data / JSON)

Parameter	Type	Required	Description
`voice_name`	string	No	The name to give to the cloned voice. (Max: 25 characters).
`gender`	integer	No	Gender of the voice. Allowed values: `1` (Male), `2` (Female), `3` (Child).
`voice_image`	file (image)	No	Image for the cloned voice. Supported types: `jpeg, png, jpg, gif, webp`. Max size: 2MB.
`voice_tags`	string	No	Optional comma-separated tags or categories for the cloned voice (e.g., "calm, formal"). (Max: 255 characters).

Success Response (200 OK)

On successful update, returns the updated cloned voice details.

Error Responses (Update Cloned Voice)

In addition to the general errors, you might encounter the following endpoint-specific errors:

404 Cloned voice not found, or you do not have permission to edit it.
422 Input validation failed (e.g., missing name, invalid file type, file too large).

DELETEDELETE Delete Cloned Voice

https://lahajati.ai/api/v1/voices/cloned/{id_voice}

Permanently deletes a cloned voice from the system and any associated external services.

Path Parameter

Parameter	Type	Required	Description
`{id_voice}`	string	Yes	The unique ID of the cloned voice to update (starts with `lvc_`). Passed as part of the URL.

Success Response (200 OK)

Confirmation message of successful deletion.

Error Responses (Delete Cloned Voice)

In addition to the general errors, you might encounter the following endpoint-specific errors:

404 Cloned voice not found, or you do not have permission to edit it.
500 Failed to delete the cloned voice (could be an issue with an external service).

Absolute Control TTS

These endpoints provide granular, advanced control over the speech generation process. You can specify dialect and performance style separately or provide a custom text prompt to get precisely the audio output you need.

GETGET Get Absolute Control Voices

https://lahajati.ai/api/v1/voices-absolute-control

Retrieves a list of voices available specifically for use with the "Generate Speech with Absolute Control" endpoint.

Query Parameters

Optional parameters to filter, sort, and paginate the results.

Parameter	Type	Required	Description
`page`	integer	No (defaults to 1)	The page number of the results to retrieve.
`per_page`	integer	No (defaults to 15, max 100)	The number of voices to return per page.
`gender`	string	No	Filter by gender. Allowed values: `1` (Male), `2` (Female), `3` (Child).

Success Response (200 OK)

Returns a paginated list of compatible voice objects.

GETGET Get Performance Styles

https://lahajati.ai/api/v1/performance-absolute-control

Retrieves a list of available performance styles (e.g., dramatic, news-like, commercial) that can be used to guide the speech generation model.

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No (defaults to 1)	The page number of the results to retrieve.
`per_page`	integer	No (defaults to 15, max 100)	The number of voices to return per page.

Success Response (200 OK)

Returns a paginated list of performance style objects.

GETGET Get Dialects

https://lahajati.ai/api/v1/dialect-absolute-control

Retrieves a list of available dialects (e.g., Egyptian, Saudi Najdi) that can be used to guide the speech generation model.

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No (defaults to 1)	The page number of the results to retrieve.
`per_page`	integer	No (defaults to 15, max 100)	The number of voices to return per page.

Success Response (200 OK)

Returns a paginated list of dialect objects.

POSTPOST Generate Speech with Absolute Control

https://lahajati.ai/api/v1/text-to-speech-absolute-control

Generates speech from text using a specified voice and fine-grained performance control via two modes: Structured Mode (using performance and dialect IDs) or Custom Prompt Mode.

Understanding the `input_mode` Parameter

This parameter is key to controlling this endpoint. It has two modes:

Mode `0` (Structured): In this mode, you pass `performance_id` and/or `dialect_id` (both are optional). The system will construct the appropriate prompt for the AI based on your selections. This is the recommended option for most use cases.
Mode `1` (Custom): In this mode, `performance_id` and `dialect_id` are ignored. Instead, you pass a detailed, free-form text prompt in `custom_prompt_text`, giving you full control. E.g., "Speak slowly and calmly, with pauses between sentences, as if you are telling a children's story."

Request Body Parameters (JSON)

Parameter	Type	Required	Description
`text`	string	Yes	The text to be converted into speech.
`id_voice`	string	Yes	GET Get Absolute Control Voices: The unique identifier for the desired voice speaker. Obtainable via the Get Voices endpoint.
`input_mode`	string ("0" or "1")	Yes	Defines the control mode. `0` for Structured Mode (using IDs), `1` for Custom Prompt Mode.
`performance_id`	string (ID)	No (Required if `input_mode` is `0`)	The ID for the performance style. Obtained from the Get Performance Styles endpoint.
`dialect_id`	string (ID)	No (Required if `input_mode` is `0`)	The ID for the dialect. Obtained from the Get Dialects endpoint.
`custom_prompt_text`	string	No (Required if `input_mode` is `1`)	A custom, detailed text prompt describing the desired performance.

Success Response

On success (`200 OK`), the response body will contain the raw audio data. The `Content-Type` header will be `audio/mpeg`.

Error Responses

In addition to the general errors, you might encounter the following endpoint-specific errors:

401 You do not have the permission or package to use this voice.
401 Your points balance is not enough to perform the voice generation process.
404 The specified `id_voice` does not exist.
422 Input validation failed. Ensure the required parameters for each `input_mode` are present.

Generate Speech with Absolute Control

Example for Structured Mode (`input_mode: "0"`)

curl -X POST "https://lahajati.ai/api/v1/text-to-speech-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: audio/mpeg" \
-d '{
  "text": "هذا اختبار للوضع المنظم.",
  "id_voice": "ac_voice_xyz789",
  "input_mode": "0",
  "performance_id": "perf_1",
  "dialect_id": "dialect_10"
}' \
--output structured_output.mp3

Example for Custom Prompt Mode (`input_mode: "1"`)

curl -X POST "https://lahajati.ai/api/v1/text-to-speech-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: audio/mpeg" \
-d '{
  "text": "هذا اختبار للتوجيه المخصص.",
  "id_voice": "ac_voice_xyz789",
  "input_mode": "1",
  "custom_prompt_text": "اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة."
}' \
--output custom_prompt_output.mp3

Example for Structured Mode (`input_mode: "0"`)

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$response = Http::withToken('YOUR_API_KEY')
    ->accept('audio/mpeg')
    ->post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', [
        'text'           => 'هذا اختبار للوضع المنظم.',
        'id_voice'       => 'ac_voice_xyz789',
        'input_mode'     => '0',
        'performance_id' => 'perf_1',
        'dialect_id'     => 'dialect_10'
    ]);

if ($response->successful()) {
    Storage::disk('public')->put('structured_output.mp3', $response->body());
}

Example for Custom Prompt Mode (`input_mode: "1"`)

$response = Http::withToken('YOUR_API_KEY')
    ->accept('audio/mpeg')
    ->post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', [
        'text'               => 'هذا اختبار للتوجيه المخصص.',
        'id_voice'           => 'ac_voice_xyz789',
        'input_mode'         => '1',
        'custom_prompt_text' => 'اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة.'
    ]);

if ($response->successful()) {
    Storage::disk('public')->put('custom_prompt_output.mp3', $response->body());
}

Example for Structured Mode (`input_mode: "0"`)

const structuredData = {
    text: "هذا اختبار للوضع المنظم.",
    id_voice: "ac_voice_xyz789",
    input_mode: "0",
    performance_id: "perf_1",
    dialect_id: "dialect_10"
};

fetch('https://lahajati.ai/api/v1/text-to-speech-absolute-control', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
        'Accept': 'audio/mpeg'
    },
    body: JSON.stringify(structuredData)
})
.then(response => response.blob())
.then(blob => console.log('Structured audio received!'))
.catch(error => console.error('Error:', error));

Example for Custom Prompt Mode (`input_mode: "1"`)

const customData = {
    text: "هذا اختبار للتوجيه المخصص.",
    id_voice: "ac_voice_xyz789",
    input_mode: "1",
    custom_prompt_text": "اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة."
};

fetch('https://lahajati.ai/api/v1/text-to-speech-absolute-control', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
        'Accept': 'audio/mpeg'
    },
    body: JSON.stringify(customData)
})
.then(response => response.blob())
.then(blob => console.log('Custom prompt audio received!'))
.catch(error => console.error('Error:', error));

Example for Structured Mode (`input_mode: "0"`)

import requests

headers = {
    'Authorization': f'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Accept': 'audio/mpeg'
}
structured_data = {
    "text": "هذا اختبار للوضع المنظم.",
    "id_voice": "ac_voice_xyz789",
    "input_mode": "0",
    "performance_id": "perf_1",
    "dialect_id": "dialect_10"
}
response = requests.post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', headers=headers, json=structured_data)

if response.status_code == 200:
    with open('structured_output.mp3', 'wb') as f:
        f.write(response.content)
    print("Structured audio saved.")

Example for Custom Prompt Mode (`input_mode: "1"`)

custom_data = {
    "text": "هذا اختبار للتوجيه المخصص.",
    "id_voice": "ac_voice_xyz789",
    "input_mode": "1",
    "custom_prompt_text": "اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة."
}
response = requests.post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', headers=headers, json=custom_data)

if response.status_code == 200:
    with open('custom_prompt_output.mp3', 'wb') as f:
        f.write(response.content)
    print("Custom prompt audio saved.")

Response Examples

Success Response (200 OK)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 98765

[... raw binary audio data ...]

Input validation failed. Ensure the required parameters for each `input_mode` are present.

{
    "success": false,
    "errors": {
        "input_mode": [
            "The input mode field is required."
        ],
        "custom_prompt_text": [
            "The custom prompt text field is required when input mode is 1."
        ]
    }
}

Get Absolute Control Voices

curl -X GET "https://lahajati.ai/api/v1/voices-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

Response Examples

{
  "success": true,
  "data": [
    {
      "id_voice": "ac_voice_xyz789",
      "display_name": "صوت تحكم مطلق - أحمد",
      "gender": "male",
      "is_cloned": false,
      "average_rating": null
    }
  ],
  "meta": { /* ... pagination info ... */ }
}

Get Performance Styles

curl -X GET "https://lahajati.ai/api/v1/performance-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

Response Examples

{
  "success": true,
  "data": [
    {
      "performance_id": "perf_1",
      "display_name": "أداء درامي"
    },
    {
      "performance_id": "perf_2",
      "display_name": "أداء إخباري"
    }
  ],
  "meta": { /* ... pagination info ... */ }
}

Get Dialects

curl -X GET "https://lahajati.ai/api/v1/dialect-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

Response Examples

{
  "success": true,
  "data": [
    {
      "dialect_id": "dialect_10",
      "display_name": "اللهجة المصرية"
    },
    {
      "dialect_id": "dialect_12",
      "display_name": "اللهجة السعودية (نجدية)"
    }
  ],
  "meta": { /* ... pagination info ... */ }
}

Text To Speech Super

Request Examples

curl -X POST "https://lahajati.ai/api/v1/text-to-speech-pro" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: audio/mpeg" \
-d '{
  "text": "مرحبًا بك في لهجتي.",
  "id_voice": "some_voice_id_example", 
  "professional_quality": 0,
  "speech_speed": 1.0
}' \
--output output_tts.mp3

Request Examples

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/text-to-speech-pro';

$response = Http::withToken($apiKey)
    ->accept('audio/mpeg')
    ->post($apiUrl, [
        'text'     => 'مرحبًا بك في لهجتي.',
        'id_voice' => 'some_voice_id_example', 
    ]);

if ($response->successful()) {
    Storage::disk('public')->put('tts_output.mp3', $response->body());
     echo "Audio saved to public/tts_output.mp3!";
} else {
    echo "Error: " . $response->status() . "\n";
    echo $response->body(); // Show error details
}

Request Examples

const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://lahajati.ai/api/v1/text-to-speech-pro';

const data = {
    text: "مرحبًا بك في لهجتي.",
    id_voice: "some_voice_id_example", 
};

async function fetchTTS() {
    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json',
                'Accept': 'audio/mpeg'
            },
            body: JSON.stringify(data)
        });

        if (!response.ok) {
           const errorData = await response.json().catch(() => ({ message: response.statusText }));
           throw new Error(`HTTP error ${response.status}: ${errorData.message || 'Unknown error'}`);
        }

        const audioBlob = await response.blob();
        console.log('Audio received!');
        // const audioUrl = URL.createObjectURL(audioBlob);
        // const audio = new Audio(audioUrl);
        // audio.play();

    } catch (e) {
        console.error('API Error:', e);
    }
}

fetchTTS();

Request Examples

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/text-to-speech-pro'

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json',
    'Accept': 'audio/mpeg'
}
data = {
    "text": "مرحبًا بك في لهجتي.",
    "id_voice": "some_voice_id_example", 
}

response = requests.post(api_url, headers=headers, json=data, stream=True)

if response.status_code == 200:
    with open('tts_output.mp3', 'wb') as f:
       for chunk in response.iter_content(chunk_size=8192):
             if chunk:
                f.write(chunk)
    print("Audio saved successfully to tts_output.mp3")
else:
    print(f"Error ({response.status_code}): {response.text}")

Response Examples

Success Response (200 OK)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 123456

[... raw binary audio data ...]

Example 422 Response Body

{
  "message": "The given data was invalid.",
  "errors": {
    "id_voice": [ "The selected id voice is invalid." ],
    "text": [ "The text field is required." ]
  }
}

Speech To Speech Super

Request Examples

curl -X POST "https://lahajati.ai/api/v1/speech-to-speech-pro" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: audio/mpeg" \
-F "audio_file=@/path/to/your/source_audio.mp3" \
-F "id_voice=target_voice_id_example" \ 
--output sts_output.mp3

Request Examples

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/speech-to-speech-pro';
$audioFilePath = storage_path('app/public/source_audio.mp3'); // Example path

$response = Http::withToken($apiKey)
    ->accept('audio/mpeg')
    ->attach(
        'audio_file', file_get_contents($audioFilePath), basename($audioFilePath)
     )
    ->post($apiUrl, [
        'id_voice'         => 'target_voice_id_example', 
    ]);

if ($response->successful()) {
     Storage::disk('public')->put('sts_output.mp3', $response->body());
     echo "Converted audio saved to public/sts_output.mp3!";
} else {
    echo "Error: " . $response->status() . "\n";
    echo $response->body();
}

Request Examples

Assumes an HTML input: <input type="file" id="stsAudioFileJs">

const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://lahajati.ai/api/v1/speech-to-speech-pro';
const audioFileInput = document.getElementById('stsAudioFileJs');

async function submitSTS() {
    if (!audioFileInput || audioFileInput.files.length === 0) {
         console.error("Please select an audio file.");
         return;
    }

    const formData = new FormData();
    formData.append('audio_file', audioFileInput.files[0]);
    formData.append('id_voice', 'target_voice_id_example'); 

    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'audio/mpeg'
            },
            body: formData
        });

        if (!response.ok) {
            const errorData = await response.json().catch(() => ({ message: response.statusText }));
            throw new Error(`HTTP error ${response.status}: ${errorData.message || 'Unknown error'}`);
        }
        const audioBlob = await response.blob();
        console.log('STS Audio received!');
    } catch (e) {
        console.error('API Error:', e);
    }
}

Request Examples

import requests

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/speech-to-speech-pro'
audio_file_path = 'source_audio.mp3'

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'audio/mpeg'
}

data_payload = {
    "id_voice": "target_voice_id_example", 
}

try:
    with open(audio_file_path, 'rb') as audio_f:
        files_payload = {'audio_file': (audio_file_path, audio_f)}
        response = requests.post(
          api_url,
          headers=headers,
          data=data_payload,
          files=files_payload,
          stream=True
        )

    if response.status_code == 200:
        with open('sts_output.mp3', 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                if chunk:
                    f.write(chunk)
        print("STS Audio saved successfully to sts_output.mp3.")
    else:
       print(f"Error ({response.status_code}): {response.text}")

except FileNotFoundError:
    print(f"Error: Source audio file not found at {audio_file_path}")
except Exception as e:
    print(f"An error occurred: {e}")

Response Examples

Success Response (200 OK)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 123456

[... raw binary audio data ...]

Example 422 Response Body (STS)

{
  "message": "The given data was invalid.",
  "errors": {
    "audio_file": [
      "The audio file must be a file of type: mp3, wav, aac, ogg, m4a, flac."
    ]
  }
}

Get Voices Super

Request Examples

curl -X GET "https://lahajati.ai/api/v1/voices?gender=1&per_page=25&page=1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

Request Examples

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/voices';

$response = Http::withToken($apiKey)
    ->acceptJson()
    ->get($apiUrl, [
       'gender' => '1',
       'per_page' => 25
     ]);

if ($response->successful()) {
    $voicesData = $response->json();
    echo json_encode($voicesData, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
     echo "Error: " . $response->status() . "\n";
     echo $response->body();
}

Request Examples

const apiKey = 'YOUR_API_KEY';
const params = new URLSearchParams({
    'gender': '1', 
    'per_page': 25,
});
const apiUrl = `https://lahajati.ai/api/v1/voices?${params.toString()}`;

async function fetchVoices() {
    try {
        const response = await fetch(apiUrl, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
            }
        });
        const data = await response.json();
        if (!response.ok) {
            throw new Error(data.message || 'Error fetching voices');
        }
        console.log('Voices:', data.data);
    } catch (e) {
        console.error('API Error:', e);
    }
}
fetchVoices();

Request Examples

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/voices'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json'
}
params = {
    'gender': '1', 
    'per_page': 25,
}

response = requests.get(api_url, headers=headers, params=params)

if response.status_code == 200:
    print(json.dumps(response.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error ({response.status_code}): {response.text}")

Response Examples

Example Success Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id_voice": "voice_id_1_example",
      "display_name": "أحمد (مصري)",
      "gender": "male",
      "is_cloned": false,
      "accent": "مصري",
      "category": "عام",
      "average_rating": 4.8,
      "preview_url": "https://..."
    }
  ],
  "links": { /* ... */ },
  "meta": { /* ... */ }
}

Create Cloned Voice Super

Request Examples

curl -X POST "https://lahajati.ai/api/v1/voices/cloned" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-F "voice_name=صوتي الجديد الرائع" \
-F "gender=1" \
-F "voice_image=@/path/to/your/avatar.jpg" \
-F "audio_file=@/path/to/your/training_sample.wav" \
-F "voice_tags=تجريبي,عربي"

Request Examples

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/voices/cloned';
$imagePath = storage_path('app/public/avatar.jpg');
$audioPath = storage_path('app/public/training_sample.wav');

$response = Http::withToken($apiKey)
    ->acceptJson()
    ->attach('voice_image', file_get_contents($imagePath), basename($imagePath))
    ->attach('audio_file', file_get_contents($audioPath), basename($audioPath))
    ->post($apiUrl, [
        'voice_name'    => 'صوتي الجديد PHP',
        'gender'        => '1',
        'voice_tags'    => 'تجريبي,PHP',
    ]);

if ($response->successful()) {
    echo json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
     echo "Error: " . $response->status() . "\n";
     echo $response->body();
}

Request Examples

Assumes HTML inputs: <input type="file" id="cvImageFileJs"> and <input type="file" id="cvAudioFileJs">

const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://lahajati.ai/api/v1/voices/cloned';
const imageInput = document.getElementById('cvImageFileJs');
const audioInput = document.getElementById('cvAudioFileJs');

async function createClonedVoice() {
    if (!imageInput.files[0] || !audioInput.files[0]) { return; }

    const formData = new FormData();
    formData.append('voice_name', 'صوتي الجديد JS');
    formData.append('gender', '1');
    formData.append('voice_image', imageInput.files[0]);
    formData.append('audio_file', audioInput.files[0]);

    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
            },
            body: formData
        });

        const result = await response.json();
        if (!response.ok) { throw new Error(result.message); }
        console.log('Cloned Voice Created:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}

Request Examples

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/voices/cloned'
image_path = 'avatar.jpg'
audio_path = 'training_sample.wav'

headers = { 'Authorization': f'Bearer {api_key}', 'Accept': 'application/json' }
data = { 'voice_name': 'صوتي الجديد Python', 'gender': '1' }

try:
    with open(image_path, 'rb') as img_f, open(audio_path, 'rb') as audio_f:
        files = {
            'voice_image': (image_path, img_f),
            'audio_file': (audio_path, audio_f)
        }
        response = requests.post(api_url, headers=headers, data=data, files=files)

    if response.status_code == 201:
         print(json.dumps(response.json(), indent=2, ensure_ascii=False))
    else:
        print(f"Error ({response.status_code}): {response.text}")
except FileNotFoundError as e:
    print(f"File not found: {e.filename}")

Response Examples

Success Response (201 Created) (201 Created)

{
  "success": true,
  "message": "Cloned voice created successfully...",
  "voice": {
    "id_voice": "lvc_a1b2c3d4e5f6",
    "name": "صوتي الجديد الرائع",
    "gender": "male",
    "status": "processing"
  }
}

Update Cloned Voice Super

Request Examples

VOICE_ID="lvc_xxxxxxxxxxxx"
curl -X PUT "https://lahajati.ai/api/v1/voices/cloned/${VOICE_ID}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"voice_name": "اسم محدث"}'

Request Examples

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$voiceId = 'lvc_xxxxxxxxxxxx';
$apiUrl = str_replace('{id_voice}', $voiceId, 'https://lahajati.ai/api/v1/voices/cloned/{id_voice}');

$response = Http::withToken($apiKey)->acceptJson()->put($apiUrl, [
    'voice_name' => 'الاسم المحدث عبر PHP',
    'gender' => '2'
]);

if ($response->successful()) {
    echo json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
    echo "Error: " . $response->status() . " " . $response->body();
}

Request Examples

const apiKey = 'YOUR_API_KEY';
const voiceId = 'lvc_xxxxxxxxxxxx';
const apiUrl = `https://lahajati.ai/api/v1/voices/cloned/{id_voice}`.replace('{id_voice}', voiceId);

async function updateClonedVoice() {
    const dataToUpdate = { voice_name: 'الاسم المحدث JS' };
    try {
        const response = await fetch(apiUrl, {
            method: 'PUT',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json',
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(dataToUpdate)
        });
        const result = await response.json();
        if (!response.ok) { throw new Error(result.message); }
        console.log('Cloned Voice Updated:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}

Request Examples

import requests
import json

api_key = 'YOUR_API_KEY'
voice_id = 'lvc_xxxxxxxxxxxx'
api_url = f"https://lahajati.ai/api/v1/voices/cloned/{id_voice}".replace('{id_voice}', voice_id)

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}
data_payload = { 'voice_name': 'الاسم المحدث Python' }

response = requests.put(api_url, headers=headers, json=data_payload)

if response.status_code == 200:
     print(json.dumps(response.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error ({response.status_code}): {response.text}")

Response Examples

Success Response (200 OK) (200 OK)

{
  "success": true,
  "message": "Cloned voice updated successfully.",
  "voice": {
    "id_voice": "lvc_xxxxxxxxxxxx",
    "name": "الاسم المحدث للصوت"
  }
}

Delete Cloned Voice Super

Request Examples

VOICE_ID="lvc_xxxxxxxxxxxx"
curl -X DELETE "https://lahajati.ai/api/v1/voices/cloned/${VOICE_ID}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

Request Examples

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$voiceId = 'lvc_xxxxxxxxxxxx';
$apiUrl = str_replace('{id_voice}', $voiceId, 'https://lahajati.ai/api/v1/voices/cloned/{id_voice}');

$response = Http::withToken($apiKey)->acceptJson()->delete($apiUrl);

if ($response->successful()) {
    echo json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
    echo "Error: " . $response->status() . " " . $response->body();
}

Request Examples

const apiKey = 'YOUR_API_KEY';
const voiceId = 'lvc_xxxxxxxxxxxx';
const apiUrl = `https://lahajati.ai/api/v1/voices/cloned/{id_voice}`.replace('{id_voice}', voiceId);

async function deleteClonedVoice() {
    try {
        const response = await fetch(apiUrl, {
            method: 'DELETE',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
            }
        });
        const result = await response.json();
        if (!response.ok) { throw new Error(result.message); }
        console.log('Delete Result:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}

Request Examples

import requests
import json

api_key = 'YOUR_API_KEY'
voice_id = 'lvc_xxxxxxxxxxxx'
api_url = f"https://lahajati.ai/api/v1/voices/cloned/{id_voice}".replace('{id_voice}', voice_id)

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json'
}
response = requests.delete(api_url, headers=headers)

if response.status_code == 200:
     print(json.dumps(response.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error ({response.status_code}): {response.text}")

Response Examples

Success Response (200 OK) (200 OK)

{
  "success": true,
  "message": "Cloned voice deleted successfully."
}