v1

latestOpenAPI 3.0.02026-07-228239173.7 KB
Client API

Endpoint for requesting audio transcription (Twitter Spaces)

post/api/v1/client/aud2txt

Headers

Accept'application/json' required

Request body

audio_urlstring required

URL of Twitter Spaces audio to transcribe

include_tsboolean required

Should transcription include timestamps

modelstring required

The model to use for transcription. Available models can be retrieved via the GET /api/v1/client/models endpoint.

return_result_in_responseboolean nullable

If true, the result will be returned directly in the response instead of only download url. Optional parameter.

webhook_urlstring uri nullable

Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters. See Webhook Documentation for payload structure and authentication details.

Example request

{
  "audio_url": "https://twitter.com/i/spaces/1nAKEERkeLbKL",
  "model": "WhisperLargeV3",
  "webhook_url": "https://your-server.com/webhooks/deapi"
}

Response

ID of the inference request.

Example response

{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}
All 82 operations