API

Translate

The current translation API uses a JSON POST request with mTLS authentication.

Base endpoint:

• https://anstranslation2.ddns.net/translate

Request fields:

• terms: list of terms to translate

• llm: enable/disable LLM-based translation fallback

• direction: translation direction (for example en_fr)

• model_id: model checkpoint path or identifier

• similarityMetric: include similarity metric in output

• multiple: return multiple candidates per term

• returnFile: return output as file payload

• llmProvider: provider name when llm is enabled

• llmModel: model name when llm is enabled

Example call (mTLS)

curl -v 'https://anstranslation2.ddns.net/translate' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "terms": ["heart failure", "respiratory distress"],
    "llm": false,
    "direction": "en_fr",
    "model_id": "/app/models/checkpoint-16539",
    "similarityMetric": true,
    "multiple": true,
    "returnFile": false,
    "llmProvider": "",
    "llmModel": ""
  }' \
  --cert ./mTLS/client.crt \
  --key ./mTLS/client.key \
  --cacert ./mTLS/ca.crt

Minimal single-term example

curl -s 'https://anstranslation2.ddns.net/translate' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "terms": ["diabetes mellitus"],
    "llm": false,
    "direction": "en_fr",
    "model_id": "/app/models/checkpoint-16539",
    "similarityMetric": false,
    "multiple": false,
    "returnFile": false,
    "llmProvider": "",
    "llmModel": ""
  }' \
  --cert ./mTLS/client.crt \
  --key ./mTLS/client.key \
  --cacert ./mTLS/ca.crt

Response

The endpoint returns JSON with translation candidates and optional scoring fields (for example model likelihood and similarity metrics when requested).