# Captions and Translations API Docs

General Information

By using Origin Nexus's [Captions and Translations API](/origin/apis-all/captions-and-translations-api-docs/rev.md), you can easily offer captions for the hearing impaired on Origin Nexus's video assets. With the captions, you can also have them translated through our partners at Rev.com and localize the videos by language. To get started, you will have to set up your account with Rev.com and then you can order the videos that you want captioned and translated to reach your diverse audience.

Before you begin:

1. Sign up for an account at Rev.com .
2. Request API Access. They will ask you to set up invoicing with them in order to enable access.
3. Once approved, Rev.com support will send you Sandbox Keys for testing.
4. Use the Sandbox Client and User Keys to test the /Rev/Order API.
5. Request Production Keys from Rev.com support.

### Usage&#xD;<br>

* Transcriptions - Sentiment analysis, keyword extraction, translations, Phrases.
* Translations - Use the transcription to translate into multiple languages for caption localization.
* Captions - Localization, ADA compliance.

### Example&#xD;<br>

Once you have API access to Rev.com you will be able to use your Rev.com Client and User API keys to send videos from IVA.

**/Rev/Orders** <br>

#### Usage and SDK Samples&#xD;<br>

`curl -v -X POST"https://ee.iva-api.com/Rev/Orders" -H "accept: application/json" -H "Ocp-Apim-Subscription-Key: [[apiKey]]" -H "Content-Type: application/x-www-form-urlencoded" -d "ClientApiKey=[[ClientKey]]&UserApiKey[[UserKey]]&VideoId=[[VideoId]]&UseSandbox=true"`

### FAQ&#xD;<br>

*If I request a notification what can I expect to be returned?*

* When the order is complete or cancelled, IVA returns a JSON object that contains the Id for the caption and the Status. Example: { "id":4, "status": “Complete” } or { "id":6, "status": "Cancelled"}.

**Is the ReferenceId in Entertainment Express the same as client\_ref in Rev?**

* No. The ReferenceId in EE only lives inside IVA. Not on Rev. The Id for the caption is used in the client\_ref in Rev.

**Can I get detailed status updates like in Rev?**

* Not currently. IVA waits for the job to be complete and when we receive notification from Rev we process and send notification to the client. Considering adding this at a future date.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.fabricdata.com/origin/apis-all/captions-and-translations-api-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.