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())