API Endpoint

POST Translation API

/api/v1/ai/translation

Translate text into one or multiple languages simultaneously, with automatic source language detection.

Request Body Parameters

Field	Type	Required	Description
`text`	string	Required	The user text to analyze or translate (Max: 15,000 characters).
`translate`	boolean	Optional	Whether to apply translation. Set to false to just detect language. Default is true.
`target_language`	string	Optional	A single language to translate into. Required if target_languages is not provided.
`target_languages`	array of strings	Optional	Translate text into multiple languages at once (Max 10 items).
`preserve_formatting`	boolean	Optional	Optional. If true, preserves HTML/XML tags and Markdown symbols verbatim without translating them. Default is true.
`protected_keys`	array of strings	Optional	Optional. List of dynamic placeholders/variables (e.g. ["user_name", "count"]) that must NOT be translated. Max 30 items.
`glossary`	object	Optional	Optional. Custom key-value terminology dictionary (e.g. {"Wallet": "Billetera"}) to enforce exact translations. Max 30 items.
`tone`	string	Optional	Optional. Custom tone style. Options: "formal", "casual", "friendly", "professional".

Important Note on Credit Usage

Your Content Size (Input Characters) is multiplied based on the number of target languages you request. For example, translating a 1,000-character text into 3 languages (target_languages array) consumes more processing credits than translating it into 1 language. Please be mindful of the content length and requested languages.

Example Request (Multiple Languages)

JSON Request

{
  "text": "Hello, how can I help you today?",
  "translate": true,
  "target_languages": ["Spanish", "French"]
}

cURL

curl -X POST https://rsflowhub.com/api/v1/ai/translation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, how can I help you today?",
    "target_languages": ["Spanish", "French"]
  }'

Example Response

JSON Response

{
  "success": true,
  "data": {
    "result": {
      "detected_language": "English",
      "translation_applied": true,
      "translated_text": "Hola, ¿cómo puedo ayudarte hoy?",
      "target_language": "Spanish",
      "translations": [
        {
          "target_language": "Spanish",
          "translated_text": "Hola, ¿cómo puedo ayudarte hoy?"
        },
        {
          "target_language": "French",
          "translated_text": "Bonjour, comment puis-je vous aider aujourd'hui ?"
        }
      ]
    }
  },
  "meta": {
    "credits_used": 3,
    "credits_remaining": 997
  }
}

Advanced Example (Formatting, Variables & Glossary)

This example demonstrates translating HTML-marked text while protecting placeholders, using a custom trademark glossary, and setting a casual tone.

Advanced JSON Request

{
  "text": "Hello {user_name}, welcome to RSFlowHub! Please check your Wallet balance.",
  "target_languages": ["Spanish"],
  "preserve_formatting": true,
  "protected_keys": ["user_name"],
  "glossary": {
    "RSFlowHub": "RSFlowHub",
    "Wallet": "Billetera"
  },
  "tone": "casual"
}

Advanced JSON Response

{
  "success": true,
  "data": {
    "result": {
      "detected_language": "English",
      "translation_applied": true,
      "translated_text": "¡Hola {user_name}, bienvenido a RSFlowHub! Por favor, revisa el saldo de tu Billetera.",
      "target_language": "Spanish",
      "translations": [
        {
          "target_language": "Spanish",
          "translated_text": "¡Hola {user_name}, bienvenido a RSFlowHub! Por favor, revisa el saldo de tu Billetera."
        }
      ]
    }
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 995
  }
}

API Request Example

Use the cURL snippet below to test the endpoint.

cURL

curl -X POST 'https://rsflowhub.com/api/v1/ai/translation' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "Hello, how can I help you today?",
    "target_languages": [
        "Spanish",
        "French"
    ]
}'

Supported Languages
The API uses advanced models and generally supports all major global languages automatically. Source language is auto-detected.