Text Intelligence Callback
Text Intelligence Callback allows you to have your submitted text processed asynchronously.
callback string
Deepgram’s Callback feature allows you to supply a callback URL to which text can be returned. When passed, Deepgram will immediately respond with a request_id before processing your text asynchronously.
To enable Callback, when you call Deepgram’s API, add a callback parameter in the query string and set it to the URL to which you would like transcriptions sent:
callback=URL
An example URL is https://example.com/callback.
Your callback URLs may reference the following protocols:
http or httpsAuthentication ensures the security and integrity of callback requests. There are two main methods for authenticating callback requests: using Basic Auth and utilizing the dg-token request header.
You may embed username-password authentication credentials in the callback URL in the format https://username:[email protected]. However, it’s important to note that only ports 80, 443, 8080, and 8443 are permitted for callbacks.
Only ports 80, 443, 8080, and 8443 are permitted for callbacks.
dg-token Request HeaderAlternatively, the callback request itself contains a header named dg-token. This header is automatically set to the API Key Identifier associated with the API Key used to submit the original request. This method provides a secure and straightforward means of authentication.
Depending on the type of submitted text, the response will vary.
When Deepgram has finished analyzing the text, it will send a POST request to the provided callback URL with an appropriate HTTP status code.
If the HTTP status code of the response to the callback POST request is unsuccessful (not 200-299), Deepgram will retry the callback up to 10 times with a 30 second delay between attempts.
CallBack_MethodTo enable the Callback Method, include the callback_method parameter in the query string. By default, the method supports POST, but you can specify PUT instead.