Translation

Translation reference

Single translations + batch jobs across providers.

Endpoints

Method	Path	Scope	Description
POST	/v1/translation/translate	translation:translate	Translate a list of segments.
POST	/v1/translation/compare	translation:translate	Fan out the same input to multiple providers (dry-run billing).
POST	/dashboard/translation/batches	translation:translate	Submit a large batch (returns a job id).

Quickstart

Try in playground →

curl -X POST https://api.valienz.io/v1/translation/translate \
  -H "Authorization: Bearer $VALIENZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targetLang": "es",
    "texts": ["Hello world"]
  }'

Errors

Code	HTTP	Description	Resolution
E_UNSUPPORTED_LANG	400	Target language not supported by any healthy provider.	Check /v1/translation/languages for the current matrix.