API Reference

Audio Download API

Audio Download API låter dig extrahera och ladda ner ljudspår från videor eller ljudkällor. Detta är ett asynkront API: du startar ett jobb och pollar sedan resultatet.

x-api-key:stringkrävs

Den här headern anger den privata nyckel du behöver för åtkomst till Hunt.

Endpoint: GET /api/v1/audio/download

query:stringkrävs

URL att ladda ner ljud från.

download_type:stringvalfritt

Önskad nedladdningstyp.

audio: laddar endast ner ljud (standard)

standard:audio

audio_quality:stringvalfritt

Önskad ljudkvalitet.

best: bästa tillgängliga kvalitet (standard)
320kbps: hög kvalitet
256kbps: standardkvalitet
128kbps: låg kvalitet

standard:best

audio_format:stringvalfritt

Önskat utdataformat för ljud.

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

Obs: detta är en formatpreferens. Vi gör vårt bästa för att leverera det begärda formatet, men på grund av tekniska begränsningar eller konverteringsproblem kan slutformatet skilja sig.

standard:mp3

max_duration:numbervalfritt

Maximal längd på det nedladdade innehållet i sekunder. Om ljudet är längre laddas endast upp till denna längd ner. Användbart för att begränsa filstorlekar eller extrahera specifika delar.

webhook_url:stringvalfritt

URL till webhook där resultat skickas. När den anges försöker systemet skicka svaret upp till 3 gånger med 5 sekunders fördröjning mellan försök. Resultaten skickas som en POST-förfrågan.

webhook_authorization:stringvalfritt

Authorization-header för webhooken. Detta gör att du kan lägga till autentisering på din webhook-endpoint.

Response

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

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

Kontrollera status för ditt jobb med job_id från Steg 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"
    }
}

Anteckningar

Vissa ljud kan inte laddas ner av följande skäl:

Privat innehåll: om innehållet är privat av ägaren
Otillgängligt innehåll: om innehållet har tagits bort eller inte längre är tillgängligt
Åldersbegränsat innehåll: om innehållet är åldersbegränsat

I dessa fall returnerar API:et ett förklarande felmeddelande.

Hämta API-nyckel

Response

Response Example (Completed)

Anteckningar

VIDEO API