> ## Documentation Index > Fetch the complete documentation index at: https://docs.reverieinc.com/llms.txt > Use this file to discover all available pages before exploring further. # Localization > Localization is a REST API that quickly translates English content into Indic languages, supporting single or multiple sentences. ## Getting Started In this guide, you’ll learn how to automatically transcribe live streaming audio in real time using Reverie's SDKs, which are supported for use with the Reverie API. > [!NOTE] > > Before you start, you'll need to follow the steps in the [Get your API > Credentials](https://docs.reverieinc.com/authentication.md) to obtain your API KEY & APP ID. ### Make your first Call Make your first API Call using the cURL request. Add your own API Credentials where it says `` & `` and then run the following example in a terminal or your favorite API client. ```bash theme={null} curl --location --request POST 'https://revapi.reverieinc.com/' \ --header 'Content-Type: application/json' \ --header 'REV-API-KEY: ' \ --header 'REV-APP-ID: ' \ --header 'src_lang: en' \ --header 'tgt_lang: hi' \ --header 'domain: generic' \ --header 'REV-APPNAME: localization' \ --header 'REV-APPVERSION: 3.0' \ --data '{ "data": [ "Reverie Language Technologies was established in 2009.", "The company head office is located in Bengaluru." ] }' ``` By default, The API will return the strings in the target language. ### SDKs Reverie has several SDKs that can make it easier to use the API. Follow these steps to use the SDK of your choice to make a Reverie Localization request. ### Install Dependencies ```bash JavaScript theme={null} npm i @reverieit/reverie-client ``` ```bash Python theme={null} pip install reverie-sdk ``` ### Translate Text to your preferred language The following code shows how to convert the text to your preferred language. ```javascript JavaScript theme={null} const ReverieClient = require("@reverieit/reverie-client"); const reverieClient = new ReverieClient({ apiKey: "YOUR-API-KEY", appId: "YOUR-APP-ID", }); async function translateText() { const translation = await reverieClient.translate({ text: "Hey there, how are you doing?", src_lang: "en", tgt_lang: "or", }); console.log(translation); } translateText(); ``` ```python Python theme={null} from reverie_sdk import ReverieClient client = ReverieClient( api_key="MY_API_KEY", app_id="MY_APP_ID", ) resp = client.nmt.localization( data=[ "Reverie Language Technologies was established in 2009.", "The company head office is located in Bangalore.", ], domain=1, src_lang="en", tgt_lang=["hi"], nmtMask=True, nmtMaskTerms=["Reverie Language Technologies"], nmtParam=True, dbLookupParam=True, segmentationParam=False, ) print(resp) ``` ```go Go theme={null} package main import ( "bytes" "encoding/json" "fmt" "io" "log" "net/http" ) const ( apiURL = "https://revapi.reverieinc.com/" apiKey = "" appID = "" ) type RequestBody struct { Data []string `json:"data"` IsBulk bool `json:"isBulk"` IgnoreTaggedEntities bool `json:"ignoreTaggedEntities"` } type APIResponse struct { ResponseList []struct { APIStatus int `json:"apiStatus"` InString string `json:"inString"` OutString string `json:"outString"` // Change []string to string } `json:"responseList"` TokenConsumed int `json:"tokenConsumed"` } func main() { text := "Reverie Language Technologies ltd is a great place to work." // Constructing JSON Request Body requestBody := map[string]interface{}{ "data": []string{text}, "isBulk": false, "ignoreTaggedEntities": false, } jsonData, err := json.Marshal(requestBody) if err != nil { log.Fatalf("Error marshaling JSON: %v", err) } // Creating HTTP Request req, err := http.NewRequest("POST", apiURL, bytes.NewBuffer(jsonData)) if err != nil { log.Fatalf("Error creating request: %v", err) } // Setting Request Headers req.Header.Set("Content-Type", "application/json") req.Header.Set("REV-API-KEY", apiKey) req.Header.Set("REV-APP-ID", appID) req.Header.Set("src_lang", "en") req.Header.Set("tgt_lang", "hi") req.Header.Set("domain", "1") req.Header.Set("cnt_lang", "en") req.Header.Set("REV-APPNAME", "localization") // Making HTTP Request client := &http.Client{} resp, err := client.Do(req) if err != nil { log.Fatalf("Error making request: %v", err) } defer resp.Body.Close() // Handle non-200 response codes if resp.StatusCode != http.StatusOK { log.Fatalf("Unexpected API response status: %d", resp.StatusCode) } // Read Response Body body, err := io.ReadAll(resp.Body) if err != nil { log.Fatalf("Error reading response body: %v", err) } // Unmarshalling JSON Response var apiResponse APIResponse err = json.Unmarshal(body, &apiResponse) if err != nil { log.Fatalf("Error unmarshaling response: %v", err) } // Check if response contains valid translation if len(apiResponse.ResponseList) > 0 { response := apiResponse.ResponseList[0] if len(response.OutString) > 0 { fmt.Println("Translated Text:", response.OutString) } else { fmt.Println("No translated text received.") } // Handling API Status if response.APIStatus != 3 { // Example: 3 might indicate partial success fmt.Printf("Warning: API returned status %d\n", response.APIStatus) } } else { fmt.Println("No response from API") } } ``` ### Results In order to see the results from Reverie, you must run the application. Run your application from the terminal. Your transcripts will appear in your shell. ```bash JavaScript theme={null} # Run your application using the file you created in the previous step # Example: npm start ``` ```python Python theme={null} # Run your application using the file you created in the previous step # Example: python main.py ``` ```go GoLang theme={null} // Run your application using the file you created in the previous step // Example: go run main.go ``` ### Analyzing the Response The API returns a `responseList`, which is an array containing the localized content. Each item includes the `inString`, representing the original input text in the source language, and the corresponding `outString`, which contains the translated text in the requested target language. ## Key Features > [card] Rapid Content Localization > > The Localization API quickly adapts English content into Indic languages, > localizing single or multiple sentences in a fraction of the time for a seamless user experience. > [card] Context-Aware Localization > > Our API analyzes the domain and context of the content, ensuring accurate localization > by adapting terms like "book" to suit the industry or intent (e.g., booking tickets vs. reading books). > [card] Cultural Nuance Adaptation > > Go beyond translation by capturing cultural references, simplifying text, > and adjusting for local conventions like measurement systems to resonate with the target audience. > [card] Wide Language Support > > Localize content into 16 Indic languages, including Hindi, Bengali, Tamil, Telugu, Marathi, > and more, ensuring broad accessibility across diverse regions. > [card] High-Quality Localization > > Deliver clear, natural, and culturally relevant translations that align with user expectations, > enhancing comprehension and engagement. > [card] Custom Localization Solutions > > Collaborate with us to tailor localization for your brand, ensuring the tone, style, > and terminology align with your specific needs and audience. ## Supported Languages | Language | Language Code | | - | - | | Hindi | hi | | English | en | | Assamese | as | | Bengali | bn | | Gujarati | gu | | Kannada | kn | | Konkani | kok | | Malayalam | ml | | Marathi | mr | | Maithili | mai | | Odia | or | | Punjabi | pa | | Tamil | ta | | Telugu | te | | Nepali | ne | | Urdu | ur | ## Supported Domains | Domain ID (For v3.0) | Domain ID (For v2.0) | Description | | - | - | - | | generic | 0 | Default domain; localizes content regardless of specific domain. | | government | 1 | Trained for accurate localization of government terminologies. | | travel | 2 | Localizes travel industry terminologies accurately. | | ecommerce | 3 | Localizes content for the ecommerce domain. | | infotainment | 4 | Translates content for the media and entertainment domain. | | bfsi | 5 | Accurately translates banking, financial services, and insurance content. | | food | 6 | Translates grocery industry terminologies into target languages. | | education | 7 | Translates content from academic books. | | medical | 8 | Serves the healthcare industry with accurate translations. | ## Sample Code > [card] Python > > Access Python SDK samples for seamless content localization using Reverie’s Localization API. Perfect for server-side translation tasks. [Open](https://github.com/reverieinc/python-sdk/tree/main/translation) > [card] JavaScript > > Explore JavaScript SDK examples to integrate real-time localization into web applications and browser-based experiences. [Open](https://github.com/reverieinc/javascript-sdk/tree/main/translation) > [card] GoLang > > Find GoLang SDK samples for fast, scalable localization solutions in backend systems and APIs. [Open](https://github.com/reverieinc/golang-sdk/tree/main/translation) ## FAQs > [accordion] What languages are supported by the Localization API? > > The Localization API supports **16 Indic languages**, including Hindi, Bengali, Tamil, Telugu, Marathi, and more, ensuring broad regional coverage. > [accordion] Can I customize translations for specific domains? > > **Yes**, the API supports domain-specific localization (e.g., government, travel, ecommerce) to accurately adapt content based on context and industry. > [accordion] Does the API handle cultural nuances? > > Absolutely. The API goes beyond translation, adapting content for **cultural references**, local conventions, and simplicity to resonate with target audiences. > [accordion] Can I create custom localization for my brand? > > Yes, Reverie offers **custom localization solutions**, allowing you to tailor tone, style, and terminology to align with your brand’s identity. > [accordion] How fast is the localization process? > > The Localization API provides **rapid localization**, translating single or multiple sentences in a fraction of the time for seamless integration. ## API Messages | Status Code | Status Type | Status | Description | | - | - | - | - | | 2 | Success | LOOKUP\_MODERATED | API fetched localization content from the database. | | 3 | Success | MT\_SUCCESS | Source content translated using Neural Machine Translation (NMT). | | 4 | Success | LOOKUP\_UNMODERATED | Localized content in database, but verification status is "unmoderated." | | 5 | Success | LOOKUP\_INPROGRESS | Localized content in database; content moderation in progress. | | 6 | Success | LOOKUP\_PARTIAL | API partially localized a segment from LookUp DB. | | 10 | Success | T13N\_SUCCESS | API fetched content from transliteration. | | -2 | Error | UNLOCALIZED | Requested content is transliterated, not translated. | | -3 | Error | ROSETTA\_ERROR | Error occurred while preprocessing the sentence. | | -4 | Error | MT\_ERROR | Error occurred during NMT translation. | | -5 | Error | MT\_TIME\_OUT | Timeout error while fetching response from NMT Engine. | | -6 | Error | LOCMAN\_ERROR | Error occurred while processing content in LocMan. | | -7 | Error | SEGMENTATION\_API\_ERROR | Error while segmenting the sentence. | | 403 | Error | unauthorized to use this src/tgt language | Invalid or unauthorized language code provided. | | 403 | Error | Invalid REV-API-KEY or REV-APP-ID | Invalid credentials provided. | | 403 | Error | usage exhausted | Provided credit limit is exhausted. | | 403 | Error | API key expired | API key provided has expired. | | 403 | Error | unauthorized to use this API | User is not authorized to use the Localization API. | | 403 | Error | Please provide data string | Data is missing. | | 403 | Error | Target language is mandatory | Target language (tgt\_lang) is missing. | | 403 | Error | Source language is mandatory | Source language (src\_lang) is missing. | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.