Valyrian translator API

API End Points

https://api.funtranslations.com/translate/
	

Ratelimiting

Our translation API is public. To maintain our service level we ratelimit the number of API calls. For public API calls this is 60 API calls a day with distribution of 5 calls an hour. For paid plans this limit is increased according to the service level described in the plan.

Authentication

For public calls you don't need to pass any API key. Just invoke the endpoint (see examples below). For paid subscriptions you need to pass the API key.

Currently we support API Key based authentication. Please set a request header 'X-FunTranslations-Api-Secret' with value of your API key. Alternatively you can also pass api_key= as a request parameter, though we strongly discourage this mode of passing the key.

Translating English text to valyrian

public ratelimited

To translate from English to valyrian use the following API.

POST  /valyrian

Translate from English to valyrian.

Parameters

---

Parameter Name	Parameter Type	Description
text	string	Text to translate.

output

---

The result is a json object with the converted text.

Here is the full url to use.

	https://api.funtranslations.com/translate/valyrian.json
	

Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.

https://api.funtranslations.com/translate/valyrian.json?text=I%20am%20Daenerys%20Stormborn%20of%20the%20House%20Targaryen%2C%20of%20the%20blood%20of%20Old%20Valyria.%20Valyrian%20is%20my%20mother%20tongue.

Here is an example using CURL to convert the given text.

	curl -v  -i -X POST  -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=I am Daenerys Stormborn of the House Targaryen, of the blood of Old Valyria. Valyrian is my mother tongue." https://api.funtranslations.com/translate/valyrian.json
	

The above call if successful will return a json response something like this.

{
  "success": {
    "total": 1
  },
  "contents": {
    "translated": "Nyke daenerys jelmāzmo hen targārio lentrot,  hen valyrio uēpo ānogār iksan. Valyrīha iksos issa muñnykeā ēngos.",
    "text": "I am Daenerys Stormborn of the House Targaryen, of the blood of Old Valyria. Valyrian is my mother tongue.",
    "translation": "valyrian"
  }
}
	

Subscribe