API dokumintaasje

Soundc.com API wurdt hosted by dvr.soundc.com .

Autentikaasje

Om tagong te krijen ta Soundc.com API, moatte jo jo unike API-kaai opnimme. Jo kinne in API-kaai krije troch jo oan te melden mei jo e-mailadres. Unthâld asjebleaft jo API-kaai fertroulik te hâlden.

Autentikaasje mei de API wurdt behannele fia HTTP-headers. Alle oanfragen fereaskje in autorisaasjekoptekst mei jo API-kaai yn de opmaakkaai: YOUR_API_KEY , wêrby't YOUR_API_KEY de kaai is dy't beskikber is op jo akkountside.

Foar feiligens moatte alle oanfragen ferstjoerd wurde oer in fersifere HTTPS-ferbining om jo gegevens te beskermjen by oerdracht.

MP3-formaat feroarje

Stjoer fideo-/audio-URL nei de Soundc.com API foar it feroarjen fan MP3-formaat. De API sil de audio / fideo automatysk ûntdekke en it tariede op optimaal ôfspieljen op ferskate apparaten.

Foarbyld foar MP3 Format-Shifting

Ferfang YOUR_API_KEY mei jo unike API-kaai (fûn op jo Soundc.com-akkountside) en ferfange AUDIO_URL mei de audio-/fideo-URL:

import requests
import base64

headers = {"Authorization": "API_KEY"}
video_url = base64.b64encode("VIDEO_URL".encode()).decode()
r = requests.post(
    url="https://dvr.soundc.com/mp3",
    headers=headers,
    data={
        "video_url": video_url,
        "start_time": False,
        "end_time": False,
        "title": "Hello world",
        "artist": "Hello world",
        "audio_quality": '128k',
    }
)

if r.status_code == 200:
    with open("audio.mp3", "wb") as fd:
        for chunk in r.iter_content(chunk_size=128):
            fd.write(chunk)
else:
    print(r.status_code)
    print(r.text)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const videoUrl = Buffer.from("VIDEO_URL").toString('base64');

const data = {
  video_url: videoUrl,
  start_time: false,
  end_time: false,
  title: "Hello world",
  artist: "Hello world",
  audio_quality: "128k"
};

axios
  .post("https://dvr.soundc.com/mp3", data, { headers })
  .then(response => {
    const fs = require('fs');
    const fileStream = fs.createWriteStream("audio.mp3");

    response.data.pipe(fileStream);

    fileStream.on('finish', () => {
      console.log("Archivo descargado con éxito como audio.mp3");
    });

    fileStream.on('error', error => {
      console.error("Error al escribir el archivo:", error);
    });
  })
  .catch(error => {
    console.error("Error en la solicitud:", error);
  });

<?php
$video_url = base64_encode("VIDEO_URL");

$data = [
    "video_url" => $video_url,
    "start_time" => "false",
    "end_time" => "false",
    "title" => "Hello world",
    "artist" => "Hello world",
    "audio_quality" => "128k",
    "format" => "mp3"
];

$postData = http_build_query($data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dvr.soundc.com/mp3");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: API_KEY",
    "Content-Type: application/x-www-form-urlencoded"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    file_put_contents("audio.mp3", $response);
    echo "✅ audio.mp3";
} else {
    echo "❌ $httpCode\n";
    echo $response;
}
?>

curl -L -X POST "https://dvr.soundc.com/mp3" \
    -H "Authorization: API_KEY" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "video_url=$(echo -n 'VIDEO_URL' | base64)" \
    --data-urlencode "start_time=false" \
    --data-urlencode "end_time=false" \
    --data-urlencode "title=Hello world" \
    --data-urlencode "artist=Hello world" \
    --data-urlencode "audio_quality=128k" \
    --data-urlencode "format=mp3" \
    --output "audio.mp3" --silent --show-error --write-out "\nHTTP_STATUS=%{http_code}"

MP4-formaat feroarje

Stjoer fideo-/audio-URL nei de Soundc.com API foar it feroarjen fan MP4-formaat. De API sil de audio / fideo automatysk ûntdekke en it tariede op optimaal ôfspieljen op ferskate apparaten.

Foarbyld foar MP4 Format-Shifting

Ferfang YOUR_API_KEY mei jo unike API-kaai (fûn op jo Soundc.com-akkountside) en ferfange VIDEO_URL troch de audio-/fideo-URL:

import requests
import base64

headers = {"Authorization": "API_KEY"}
video_url = base64.b64encode("VIDEO_URL".encode()).decode()
r = requests.post(
    url="https://dvr.soundc.com/mp4",
    headers=headers,
    data={
        "video_url": video_url,
        "start_time": False,
        "end_time": False,
        "title": "hello world",
        "video_quality": 720
    }
)

if r.status_code == 200:
    with open("video.mp4", "wb") as fd:
        for chunk in r.iter_content(chunk_size=128):
            fd.write(chunk)
else:
    print(r.status_code)
    print(r.text)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const videoUrl = Buffer.from("VIDEO_URL").toString('base64');

const data = {
  video_url: videoUrl,
  start_time: false,
  end_time: false,
  title" "hello world",
  video_quality: 720
};

axios
  .post("https://dvr.soundc.com/mp3", data, { headers })
  .then(response => {
    const fs = require('fs');
    const fileStream = fs.createWriteStream("audio.mp3");

    response.data.pipe(fileStream);

    fileStream.on('finish', () => {
      console.log("Archivo descargado con éxito como audio.mp3");
    });

    fileStream.on('error', error => {
      console.error("Error al escribir el archivo:", error);
    });
  })
  .catch(error => {
    console.error("Error en la solicitud:", error);
  });

<?php
$video_url = base64_encode("VIDEO_URL");

$data = [
    "video_url" => $video_url,
    "start_time" => "false",
    "end_time" => "false",
    "title" => "Hello world",
    "video_quality" => "720"
];

$postData = http_build_query($data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dvr.soundc.com/mp4");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: API_KEY",
    "Content-Type: application/x-www-form-urlencoded"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    file_put_contents("video.mp4", $response);
    echo "✅ video.mp4";
} else {
    echo "❌ $httpCode\n";
    echo $response;
}
?>

curl -L -X POST "https://dvr.soundc.com/mp4" \
     -H "Authorization: API_KEY" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     --data-urlencode "video_url=$(echo -n 'VIDEO_URL' | base64)" \
     --data-urlencode "start_time=false" \
     --data-urlencode "end_time=false" \
     --data-urlencode "title=hello world" \
     --data-urlencode "video_quality=720" \
     --data-urlencode "format=mp4" \
     --output video.mp4 --silent --show-error --write-out "\nHTTP_STATUS=%{http_code}"

Glossary of parameters

video_url

string (required)

De audio/fideo-URL yn base64. Kontrolearje alle siden dy't wy stypje. Klik hjir

start_time

int

Dit wurdt brûkt om de audio of fideo te trimmen en stiet foar de twadde wêrop jo wolle dat de audio-/fideo-opname begjint. Jo kinne false stjoere om oan te jaan dat it moat begjinne fan 'e 0ste sekonde.

end_time

int / bool (false)

Dit wurdt brûkt om de audio of fideo te trimmen en stiet foar de twadde wêrop jo wolle dat de audio-/fideo-opname einiget. Jo kinne <code>false</code> stjoere as jo de audio/fideo net wolle trimme.

title

string (required)

De titel wêrunder de audio/fideo sil wurde opnommen; it wurdt ek brûkt om de generearre triem te neamen.

artist

string

De namme fan de artyst dêr't it bestân ûnder opnaam wurdt.

audio_quality

string

De kwaliteit wêrop it audiobestân sil wurde opnommen. De beskikbere kwaliteiten binne 32k , 64k , 128k , 256k , of 320k .

video_quality

string

De kwaliteit wêrop it fideobestân sil wurde opnommen. De beskikbere kwaliteiten binne 144 , 240 , 360 , 480 , 720 (foar HD), 1080 (foar UHD), 2160 (foar 4k), of 4320 (foar 8k).