Skip to main content
GET
/
audio
/
{audio_id}
Get audio details
curl --request GET \
  --url https://api.videodb.io/audio/{audio_id} \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": {
    "id": "a-12345",
    "name": "audio.mp3",
    "collection_id": "default",
    "length": 60,
    "size": 524288,
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.videodb.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve metadata for a specific audio file by its ID. 
import videodb

conn = videodb.connect(api_key="your_api_key")
coll = conn.get_collection()

# Get audio details
audio = coll.get_audio("a-abc123def")
print(f"ID: {audio.id}")
print(f"Name: {audio.name}")
print(f"Duration: {audio.length}s")
print(f"Collection: {audio.collection_id}")
  • Audio IDs always start with a- prefix
  • The length property contains duration in seconds
  • Use this to retrieve metadata before generating streams or download URLs

List All Audio

View all audio files in collection

Generate URL

Create streaming or download URLs

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

​
audio_id
string
required
Pattern: ^a-
Example:

"a-12345"

Query Parameters

​
collection_id
string
Example:

"default"

Response

200 - application/json

Audio details

​
success
boolean
Example:

true

​
data
object