Arcalate API

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.

Quickstart

  • Base URL: https://www.arcalate.com/api
  • Authentication: pass your secret key using the x-api-key header
  • Content-Type for every request body must be application/json

Required headers:

Content-Type: application/json
x-api-key: YOUR_API_KEY

POST /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).
Translate Example
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())

POST /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.
Detect Language Example
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())

GET /supported_languages

Returns a list of language codes and human‑readable names supported by Arcalate.

This endpoint does not accept a request body.

Supported Languages Example
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())