Hacker News new | ask | show | jobs
by simion314 1587 days ago
I am talking about they have one documentation but if you look deeper there are 2 products, thay say here are 2 options long and short API , but look closer and see one uses names like "Name", "Voice" the other "name", "voice" , the list of voices of this 2 options are not the same , and you randomly get weird errors with shit message that will solve themselves in the next few days. If my memory is correct you authenticate in2 different ways.

So I would prefer MS do this;

1 this is our 2 completly different and incompatible APIs , they might look similar but are not the same, outpiut can differ even if you send same params to each one

2 give me good error messages, like if is your fault a request fails make it clear , if is my input the problem make it clear it is me and what is wrong

1 comments

I mean, there's the old Windows-only SAPI from the Windows XP days that they haven't been developing for several years now, and the current Azure Cognitive Services, which is just a REST API with a pretty standard auth scheme. There's an official .NET package for wrapping that REST API, but it's certainly not necessary to use it if you know how to handle REST APIs. Is that what you're talking about?
Yes, the Azure API, there are 2 different things under the hood, the short and login APIs, that are different names, different auth headers, different voices supported, voices with same name that have different styles supported. Bad errors messages that popup and get fixed in a few days but only on one of the APIs. The issue is that I am trying to combine the short and long APIs in one product and I am hitting this big inconsistencies, I see lcearly there are 2 teams and do things different , if you use only one section you have a completly different experience.

Edit. I do the REST calls directly, not via an SDK and use the documentation from MS for the REST API so no SDK documentation or SDK code that hides the issues.