API Dokumentatioun

Yout.com API gëtt op dvr.yout.com gehost.

Authentifikatioun

Fir Zougang zu Yout.com API ze kréien, musst Dir Ären eenzegaartegen API Schlëssel enthalen. Dir kënnt en API Schlëssel kréien andeems Dir Iech mat Ärer E-Mailadress umellt. Erënnert w.e.g. Ären API Schlëssel vertraulech ze halen.

Authentifikatioun mat der API gëtt iwwer HTTP Header gehandhabt. All Ufroe erfuerderen en Autorisatiouns-Header mat Ärem API-Schlëssel am Format-Schlëssel: YOUR_API_KEY , wou YOUR_API_KEY de Schlëssel ass, deen op Ärer Kont Säit verfügbar ass.

Fir Sécherheet mussen all Ufroe iwwer eng verschlësselte HTTPS Verbindung geschéckt ginn fir Är Donnéeën während der Iwwerdroung ze schützen.

MP3 Format-Verréckelung

Schéckt Video / Audio URL un d'Yout.com API fir MP3 Format-Verréckelung. D'API erkennt den Audio / Video automatesch a preparéiert se op eng optimal Playback op verschiddenen Apparater.

Beispill fir MP3 Format-Shifting

Ersetzt YOUR_API_KEY mat Ärem eenzegaartegen API Schlëssel (fonnt op Ärer Yout.com Kont Säit) an ersetzt AUDIO_URL mat der Audio/Video URL:

import requests
import base64

headers = {"Authorization": "API_KEY"}
audio_url = base64.b64encode("AUDIO_URL")
r = requests.post(
    url="http://dvr.yout.com/mp3",
    headers=headers,
    data={
        "video_url": audio_url,
        "start_time": False,
        "end_time": False,
        "title": "Hello world",
        "artist": "Hello world",
        "audio_quality": '128k',
    }
)

with open("audio.mp3" "wb") as fd:
    for chunk in r.iter_content(chunk_size=128):
        fd.write(chunk)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const audioUrl = Buffer.from("AUDIO_URL").toString('base64');

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

axios
  .post("http://dvr.yout.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
$audio_url = base64_encode("AUDIO_URL");

// Datos para enviar en la solicitud POST
$data = [
    "video_url" => $audio_url,
    "start_time" => false,
    "end_time" => false,
    "title" => "Hello world",
    "artist" => "Hello world",
    "audio_quality" => "128k"
];

// Convertir los datos a formato URL-encoded
$postData = http_build_query($data);

// Configurar la solicitud cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://dvr.yout.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);

// Ejecutar la solicitud
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    // Guardar el archivo de audio
    $file = fopen("audio.mp3", "wb");
    fwrite($file, $response);
    fclose($file);
    echo "Archivo descargado con éxito como audio.mp3";
} else {
    echo "Error en la solicitud. Código HTTP: $httpCode";
}
?>

curl -X POST "http://dvr.yout.com/mp3" \
         -H "Authorization: API_KEY" \
         -H "Content-Type: application/x-www-form-urlencoded" \
         -d "video_url=$(echo -n 'AUDIO_URL' | base64)" \
         -d "start_time=false" \
         -d "end_time=false" \
         -d "title=Hello world" \
         -d "artist=Hello world" \
         -d "audio_quality=128k" \
         --output audio.mp3

MP4 Format-Verréckelung

Schéckt Video / Audio URL un d'Yout.com API fir MP4 Format-Verréckelung. D'API erkennt den Audio / Video automatesch a preparéiert se op eng optimal Playback op verschiddenen Apparater.

Beispill fir MP4 Format-Shifting

Ersetzt YOUR_API_KEY mat Ärem eenzegaartegen API Schlëssel (fonnt op Ärer Yout.com Kont Säit) an ersetzt VIDEO_URL mat der Audio/Video URL:

import requests
import base64

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

with open("audio.mp4" "wb") as fd:
    for chunk in r.iter_content(chunk_size=128):
        fd.write(chunk)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const audioUrl = Buffer.from("AUDIO_URL").toString('base64');

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

axios
  .post("http://dvr.yout.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, "http://dvr.yout.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 = fopen("video.mp4", "wb");
    fwrite($file, $response);
    fclose($file);
    echo "Archivo descargado con éxito como video.mp4";
} else {
    echo "Error en la solicitud. Código HTTP: $httpCode";
}
?>

curl -X POST "http://dvr.yout.com/mp4" \
     -H "Authorization: API_KEY" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "video_url=$(echo -n 'VIDEO_URL' | base64)" \
     -d "start_time=false" \
     -d "end_time=false" \
     -d "title=hello world" \
     -d "video_quality=720" \
     --output video.mp4

Glossary of parameters

video_url

string (required)

D'Audio / Video URL an base64. Kuckt all d'Säiten déi mir ënnerstëtzen. Klickt hei

start_time

int

Dëst gëtt benotzt fir den Audio oder Video ze trimmen a stellt déi zweet duer wou Dir wëllt datt d'Audio/Video Opnam ufänken. Dir kënnt false schécken fir unzeginn datt et vun der 0. Sekonn sollt ufänken.

end_time

int / bool (false)

Dëst gëtt benotzt fir den Audio oder Video ze trimmen a representéiert déi zweet op där Dir wëllt datt d'Audio/Video Opnam ophalen. Dir kënnt <code>false</code> schécken wann Dir den Audio / Video net wëllt trimmen.

title

string (required)

Den Titel ënner deem den Audio/Video opgeholl gëtt; et gëtt och benotzt fir déi generéiert Datei ze nennen.

artist

string

Den Numm vum Kënschtler ënner deem de Fichier opgeholl gëtt.

audio_quality

string

D'Qualitéit bei där d'Audiodatei opgeholl gëtt. Déi verfügbar Qualitéite sinn 32k , 64k , 128k , 256k oder 320k .

video_quality

string

D'Qualitéit bei där d'Videodatei opgeholl gëtt. Déi verfügbar Qualitéite sinn 144 , 240 , 360 , 480 , 720 (Fir HD), 1080 (Fir UHD), 2160 (Fir 4k), oder 4320 (Fir 8k).