API - Translator Text / Speech: Using the API key directly in the call. No more token.

Using the API key directly in the call. No more token required.

You can now use the Azure API key directly in the API call. It is not necessary to exchange the key to a token before using it in the API call. While the previous method of using a token still works, we recommend updating your code for improved performance and reliability, now avoiding the additional round trip.


In your http request to or, set the http header "Ocp-Apim-Subscription-Key" to your subscription key.

Do not make a call to the token service (

Do not use the appid parameter or the "Authorization" http header. 

The documentation at is updated accordingly. 
A C# example is here:

Last update: October 13, 2017


  1. Announcement: Changes to the Collaborative Translation functions
  2. Translator Hub replaces the Collaborative Translation Framework (CTF)
  3. Microsoft Translator Moves to the Azure portal
  4. API - Translator datacenters
  5. API and Hub: Confidentiality
  6. API - Translator Speech: Microsoft Translator Speech API references
  7. API - Translator Text: How to report an issue with the API
  8. API - Translator Text / Speech: Microsoft Translator with IP filtered firewalls
  9. API - Translator Text / Speech: Get a report of your consumption
  10. API - Translator Text / Speech: Using the API key directly in the call. No more token.
  11. API - Translator Text / Speech: Why are there two keys for my API subscription?
  12. API - Translator Text: Hybrid Neural Machine Translation
  13. API - Translator Text: Using Neural MT Systems
  14. API- Translator Text: Standard category languages
  15. API - Translator Text: My CAT tool isn't working and is asking for the Client ID and Client Secret
  16. API - Translator Text: Limits
  17. API - Translator Text: How Microsoft Translator counts characters
  18. API - Translator Text: Gender selection in the Speak() method
  19. API - Translator Text: Trados plugin for Microsoft Translator
  20. API - Translator Text: Java- Using SSL with the Microsoft Translator API
  21. API - Translator Text: European datacenter
  22. API - Translator Text: Languages detected by the Detect() method
  23. API - Translator Text: First few Microsoft Translator API requests succeed, then the calls fail
  24. API - Translator Text: Profanity filtering in the TranslateArray() method
  25. Hub: API available
  26. Hub: Translator Hub Resource Guide
  27. Hub: August 2016 Release notes
  28. Hub: Deployment of a custom system requires a Microsoft Translator Text API subscription in the Azure portal
  29. Hub: Capacity of custom Microsoft Translator Hub systems
  30. Hub: Building a custom system using a dictionary only
  31. Business Applications: Security and Privacy in Microsoft Office Products

Feedback and Knowledge Base