How should my request look for synchronous document translation (Error: The Document field required)

Joe Petrakovich 0

I'm trying to use synchronous document translation but am getting a "The Document field is required" error.

I've included the document as an HTML file sent as a blob in FormData. I also tried adding and removing the query string document param even though I don't really understand the point of a file path since the document itself is in the body, so there's not really path.. I just made one up..

How can I get this to work?

User's image

romungi-MSFT 46,831 Reputation points Microsoft Employee

2024-09-16T13:50:08.7166667+00:00

@Joe Petrakovich Have you tried to check if the request is processed if you just use CURL request with this resource, like the one mentioned here.

I see the output path is not mentioned in your request, try adding that too as part of the request parameter along with the document parameter.

You might also want to log the request passed to the service to understand what is missing from the curl request where the document or text is not detected when the request is processed. Thanks!!
Joe Petrakovich 0 Reputation points

2024-09-17T05:57:34.7433333+00:00

@romungi-MSFT I tried using the example CURL with the example document and still get the same "Document field is required" error.

By the way I think the WAF for learn.microsoft.com is catching false positives and blocking my replies because they have code blocks. I tried 5 different times to reply but got red "you are not authorized" errors so I had to resort to sending a screenshot.

output goes in the temp-sample-trans.docx file:
Joe Petrakovich 0 Reputation points

2024-09-17T06:11:54.8933333+00:00

I cant seem to reply with screenshots or code blocks because of an unauthorized error...

I tried the curl with the example document and still get the same "Document field is required" error. The document is in the expected path with the correct name.
romungi-MSFT 46,831 Reputation points Microsoft Employee

2024-09-20T10:23:50.4733333+00:00

@Joe Petrakovich Did you get a chance to check if the above suggestion helped?

1 answer

romungi-MSFT 46,831 Reputation points Microsoft Employee

2024-09-17T08:02:13.06+00:00

@Joe Petrakovich I think the problem here is with the missing @ in the file path, here is my actual request that worked.

Here is the path format that you have to use for file parameter.

-F "document=@"C:\Users\romungi\margies_faq.docx";type=application/vnd.openxmlformats-officedocument.wordprocessingml.document"

Final output of my file translated to Spanish:

I think the documentation did not cover the missing @ in the path for document parameter causing this confusion. Please retry with this change and I think it should work for you.

Also, this platform blocks some requests when it thinks the code snippet is malicious, in that case, use the screenshot as you have done above. Thanks!!
Please sign in to rate this answer.

0 comments No comments
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.

Share via

How should my request look for synchronous document translation (Error: The Document field required)

1 answer

Your answer