Submit text for translation.
The following formats are supported (specified via the Content-Type header):
text/plain- Simple UTF-8 encoded text.application/subrip- A UTF-8 encoded SRT file.application/json- A json object or array. All string values within the json object or array are translated.
User request completion callback
When submitting a request, an optional HTTP callback can be specified which will be invoked when the request completes or fails. The callback is an HTTP POST to the exact URL provided. Only one attempt is made to reach the URL provided. The contents of the HTTP request match the response from the Querying a request status and retrieving results above.
Headers
x-requestid: Contains therequest_idreceived when the request was submittedx-status: One of the following indicating the status of the request:
| Status | Description |
|---|---|
| “Completed” | The request has finished processing and the user callback, if provided has been called. |
| “Failed” | An error occurred processing the request. |
x-error: If the request failed, this would contain an error message.x-userdata: This will contain the user data supplied with the original request.
Body
If the status is “Completed” the body of the request contains the results from the translation. If the status is “Failed” the body of the request contains the same error message provided in the x-error header.
Using meta controls
One or more meta control values are provided in the meta_controls query parameter. The control values are provided using the following structure:
{control}:{value},{control}:{value},etc.
E.g.
meta_controls=gender:female,genre:newswire
The meta_controls available for a model is provided in the meta_controls array of the model description returned by the Query available translation models method.