API Reference

Audio Download API

Audio Download API pozwala wyciągać i pobierać ścieżki audio z wideo lub źródeł audio-only. To asynchroniczne API: inicjujesz job, a następnie odpytyjesz wynik.

x-api-key:stringwymagane

Ten nagłówek określa prywatny klucz potrzebny do dostępu do Hunt.

Endpoint: GET /api/v1/audio/download

query:stringwymagane

URL, z którego ma zostać pobrane audio.

download_type:stringopc

Pożądany typ pobierania.

audio: pobiera tylko audio (domyślnie)

domyślnie:audio

audio_quality:stringopc

Pożądana jakość audio.

best: najlepsza dostępna jakość (domyślnie)
320kbps: wysoka jakość
256kbps: standardowa jakość
128kbps: niska jakość

domyślnie:best

audio_format:stringopc

Pożądany format wyjściowy audio.

mp3: format MP3 (domyślnie)
m4a: MPEG-4 Audio
wav: Waveform Audio File Format

Uwaga: to preferencja formatu. Postaramy się dostarczyć żądany format, ale ze względu na ograniczenia techniczne lub problemy z konwersją finalny format może się różnić.

domyślnie:mp3

max_duration:numberopc

Maksymalny czas trwania pobieranego materiału w sekundach. Jeśli audio jest dłuższe, pobierzemy tylko do tej długości. Przydatne do ograniczenia rozmiaru plików lub wycięcia fragmentów.

webhook_url:stringopc

URL webhooka, na który zostaną wysłane wyniki. Gdy jest podany, system spróbuje wysłać odpowiedź do 3 razy z 5-sekundowym odstępem. Wyniki są wysyłane jako POST.

webhook_authorization:stringopc

Nagłówek Authorization dla webhooka. Pozwala dodać uwierzytelnianie do Twojego endpointu webhook.

Response

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

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

Sprawdź status joba używając job_id zwróconego w Kroku 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"
    }
}

Uwagi

Niektórych materiałów audio nie da się pobrać z następujących powodów:

Prywatna treść: gdy treść jest ustawiona jako prywatna przez właściciela
Treść niedostępna: gdy treść została usunięta lub nie jest już dostępna
Ograniczenie wiekowe: gdy treść jest ograniczona wiekowo

W takich przypadkach API zwróci opisowy komunikat błędu.

Uzyskaj API Key

Response

Response Example (Completed)

Uwagi

VIDEO API