IMimentiv
Audio Emotion API

Get Audio Playback Url Route

Changed on

Get a short-lived URL for playing back an audio.

The returned url streams the stored audio inline in a browser or media player. It is short-lived: request a new one when expires_at passes or when a request made with it is refused, and do not store or share it. The audio's url and media_source_url fields are references to the stored media, not guaranteed to be readable; this endpoint is how to play it.

Access Control: the same as the audio details. The owner and admins can always get a playback URL. While an audio (or the video it belongs to) is shared, or is a sample, anyone can, so sharing lets anyone with its link play it back.

Errors:

  • 401: not authorized to access this audio
  • 404: audio not found
  • 409 media_not_stored: the audio has no stored copy to play (for example, an audio submitted by URL whose copy is not ready yet)
  • 503 media_storage_unavailable: temporarily unavailable; try again shortly
get/v2/audios/{audio_id}/playback-url

Request

  • Base URL
    https://api.imentiv.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://api.imentiv.ai/oauth/authorize
      Token URL: https://api.imentiv.ai/oauth/token scopes: media.read

Path parameters

audio_idstring required

The unique ID of the audio.

Response

Successful Response

urlstring required

Signed URL that streams the media inline. Short-lived: request a new one when expires_at passes or a request with it is refused. Do not store or share it.

expires_atstring required

RFC 3339 UTC instant at which url stops working, e.g. 2026-09-28T12:30:00Z.

content_typestring required

The stored media's content type, e.g. video/mp4.

Changes