Welcome to the Arcalate REST API. With just a single HTTP request you can translate text, detect the language of a piece of text, and query the list of supported languages. All endpoints are JSON based and protected via an x-api-key
header.
https://www.arcalate.com/api
x-api-key
header
application/json
Required headers:
Content-Type: application/json
x-api-key: YOUR_API_KEY
/translate
Translates the provided text into the desired target language. You can optionally specify the source language, choose a model, and request the model to share its reasoning.
Field | Type | Required | Description |
---|---|---|---|
text | string | ✔ | The content you want to translate. |
targetLanguage | string | ✔ | Language code of the desired output (e.g. es , fr ). |
sourceLanguage | string | — | Language code of the input text. Defaults to auto to auto‑detect. |
model | string | — | Model to use. Allowed values: arcalate (default) or arcalate‑thinking . |
reasoning | boolean | — | If true , the response will include the model's reasoning steps (slower). |
import requests, json
url = "https://www.arcalate.com/api/translate"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
payload = {
"text": "Hello, world!",
"targetLanguage": "es",
# optional
"sourceLanguage": "auto",
"model": "arcalate",
"reasoning": False
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
/detect_language
Detects the language of the provided text and returns a language code and name.
Field | Type | Required | Description |
---|---|---|---|
text | string | ✔ | Text whose language should be detected. |
import requests
url = "https://www.arcalate.com/api/detect_language"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
response = requests.post(url, headers=headers, json={"text": "Bonjour tout le monde"})
print(response.json())
/supported_languages
Returns a list of language codes and human‑readable names supported by Arcalate.
This endpoint does not accept a request body.
import requests
url = "https://www.arcalate.com/api/supported_languages"
headers = {"x-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())