API Docs
API Docs
Text Translation
Translate text from one language to another using our Text Translation API.
Create Translation Request
/api/ttt
This endpoint creates a text translation request using the selected translation model. The request is processed asynchronously to ensure high performance and scalability.
Once the request is accepted, the API returns a unique log_id which can be used to fetch the final translated output.
Request Body
project_title (string, required)
A human-readable title to identify the translation project.
Example: "My Project"
input_text (string, required)
The original text that needs to be translated.
Example: "Hello world"
input_language (string, required)
Language of the input text (for example: english, hindi, french).
View example →output_language (string, required)
Target language into which the text should be translated.
View example →model (string, required)
Translation model to be used. Defaults to the best available model if not provided.
View example →Response
On successful submission, the API returns a unique log_id.
Use this log_id with the Fetch Translation by ID endpoint to retrieve the translated text and detailed processing status.
{
"log_id": "694d96ef7d5247d58c02984c"
}curl
curl --location 'https://api.narris.io/api/ttt' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"project_title": "My Project",
"input_text": "Hello world",
"input_language": "english",
"output_language": "hindi",
"model": "narris"
}'Fetch Translation List
/api/ttt/logs
This endpoint allows you to fetch a paginated list of previously created text translation requests.
Each entry represents a translation job and includes its current status, creation time, and completion time (if available).
Request Body
page (number, optional)
Page number for pagination.
Example: 1
limit (number, optional)
Number of records to return per page.
Example: 10
Response
On success, the API returns a paginated list of translation logs.
Each log contains a unique _id which can be used with the Fetch Translation by ID endpoint to retrieve the translated text.
{
"total": 6,
"page": 1,
"limit": 10,
"logs": [
{
"_id": "694d96ef7d5247d58c02984c",
"project_title": "My Project",
"status": "finished",
"createdAt": "2025-12-25T19:56:31.223Z",
"finishedAt": "2025-12-25T19:56:36.873Z"
},
{
"_id": "693c130049313684a7af0c98",
"project_title": "My Project",
"status": "pending",
"createdAt": "2025-12-12T13:05:04.420Z"
}
]
}curl
curl --location 'https://api.narris.io/api/ttt/logs?page=1&limit=10' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Fetch Translation By ID
/api/ttt/{log_id}
This endpoint allows you to fetch the complete details of a text translation request using its unique log_id.
The response includes the original input text, source and target languages, translation model used, current status, and the final translated output (if completed).
Request Body
log_id (string, required)
Unique identifier of the translation request returned during creation or from the translation logs.
Example: "693c1898994dd0b1664ee1e7"
Response
On success, the API returns detailed information about the translation request.
If the translation is completed, the output_text field will contain the translated result.
{
"_id": "693c1898994dd0b1664ee1e7",
"project_title": "My Project",
"input_text": "Hello world",
"input_language": "english",
"output_language": "hindi",
"model": "narris",
"status": "finished",
"createdAt": "2025-12-12T13:28:56.542Z",
"updatedAt": "2025-12-12T13:30:30.122Z",
"finishedAt": "2025-12-12T13:30:30.121Z",
"output_text": "हैलो वर्ल्ड"
}curl
curl --location 'https://api.narris.io/api/ttt/693c1898994dd0b1664ee1e7' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Notes for Developers
• Text translation requests are processed asynchronously. Always use the returned log_id to track the translation status.
• A translation may remain in pending or processing state for a short period depending on system load.
• Use the Fetch Translation List endpoint to view all translation jobs and the Fetch Translation By ID endpoint to retrieve the final translated output.