API Reference

Audio Download API

Audio Download API gør det muligt at udtrække og downloade lydspor fra videoer eller rene lydkilder. Dette er et asynkront API: du starter et job og poller derefter resultatet.

x-api-key:stringpåkrævet

Denne header angiver den private nøgle, du skal bruge for adgang til Hunt.

Endpoint: GET /api/v1/audio/download

query:stringpåkrævet

URL at downloade lyd fra.

download_type:stringvalgfri

Ønsket downloadtype.

audio: downloader kun lyd (standard)

standard:audio

audio_quality:stringvalgfri

Ønsket lydkvalitet.

best: bedst tilgængelige kvalitet (standard)
320kbps: høj kvalitet
256kbps: standard kvalitet
128kbps: lav kvalitet

standard:best

audio_format:stringvalgfri

Ønsket outputformat for lyd.

mp3: MP3-format (standard)
m4a: MPEG-4 Audio
wav: Waveform Audio File Format

Bemærk: dette er en formatpræference. Vi gør vores bedste for at levere det ønskede format, men pga. tekniske begrænsninger eller konverteringsproblemer kan det endelige format afvige fra det ønskede.

standard:mp3

max_duration:numbervalgfri

Maksimal varighed af det downloadede indhold i sekunder. Hvis lyden er længere end denne værdi, downloades kun op til denne varighed. Nyttigt for at begrænse filstørrelser eller udtrække specifikke dele.

webhook_url:stringvalgfri

URL til webhook hvor resultater sendes. Når den er angivet, forsøger systemet at sende svaret op til 3 gange med 5 sekunders delay mellem forsøg. Resultater sendes som en POST-forespørgsel.

webhook_authorization:stringvalgfri

Authorization header til webhook. Dette giver mulighed for at tilføje autentificering til dit webhook-endpoint.

Response

{
    "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Endpoint: GET /api/v1/jobs/{job_id}

Tjek status på dit job ved at bruge job_id fra Trin 1.

Response Example (Completed)

{
    "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
    "status": "CompletedJob",
    "result": {
        "metadata": {
            "title": "Example Audio Title",
            "duration": 180,
            "upload_date": 1729641600
        },
        "response": "https://s3.huntapi.com/audios/audio_id.mp3"
    }
}

Noter

Nogle lydfiler kan ikke downloades af følgende årsager:

Privat indhold: hvis indholdet er sat som privat af ejeren
Utilgængeligt indhold: hvis indholdet er slettet eller ikke længere kan tilgås
Aldersbegrænset indhold: hvis indholdet er aldersbegrænset

I disse tilfælde vil API’et returnere en forklarende fejlbesked.

Få API-nøgle

Response

Response Example (Completed)

Noter

VIDEO API