Skip to main content
POST
/
api
/
v1
/
client
/
aud2txt
cURL
curl --request POST \
  --url https://api.deapi.ai/api/v1/client/aud2txt \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "audio_url": "https://twitter.com/i/spaces/1nAKEERkeLbKL",
  "include_ts": true,
  "model": "WhisperLargeV3",
  "return_result_in_response": false
}
'
{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}
Prerequisite: To ensure a successful request, you must first consult the Model Selection endpoint to identify a valid model slug, check specific limits and features, and verify LoRA availability.

​
Technical Notes & Constraints

​
Spaces Support

  • Completed Spaces Only: The API does not support live (ongoing) X Spaces. If a URL for an active Space is provided, the API will return a validation error. Please ensure the Space has ended before submission.
  • Max Duration: 90 minutes

​
Progress Tracking (URL/Spaces)

  • Download Phase: Due to external stream handling, the task progress will remain at 0% for the entire duration of the audio download.
  • Transcription Phase: Once the download is complete, the progress status will jump to 50% and update incrementally until finished.
  • A prolonged 0% status is normal behavior for long X Spaces.
Transcription for standard video posts on X is handled via the Video-to-Text endpoint.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
enum<string>
default:application/json
required
Available options:
application/json

Body

application/json

Audio transcription parameters

​
audio_url
string
required

URL of Twitter Spaces audio to transcribe

Example:

"https://twitter.com/i/spaces/1nAKEERkeLbKL"

​
include_ts
boolean
required

Should transcription include timestamps

​
model
string
required

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

Example:

"WhisperLargeV3"

​
return_result_in_response
boolean | null
default:false

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

Example:

false

Response

ID of the inference request.

​
data
object

Information from success endpoint