API-dokumentado

Yout.com API estas gastigita ĉe dvr.yout.com .

Aŭtentikigo

Por aliri Yout.com API, vi devas inkluzivi vian unikan API-ŝlosilon. Vi povas akiri API-ŝlosilon per aliĝo kun via retadreso. Bonvolu memori konservi vian API-ŝlosilon konfidenca.

Aŭtentikigo kun la API estas pritraktata per HTTP-titoloj. Ĉiuj petoj postulas Rajtigan kaplinion enhavantan vian API-ŝlosilon en la formatŝlosilo: YOUR_API_KEY , kie YOUR_API_KEY estas la ŝlosilo disponebla en via konta paĝo.

Por sekureco, ĉiuj petoj devas esti senditaj per ĉifrita HTTPS-konekto por protekti viajn datumojn dum transdono.

MP3-formatoŝanĝo

Sendu video/aŭdian URL al la Yout.com API por MP3-formatŝanĝo. La API aŭtomate detektos la audio/videon kaj preparos ĝin por optimuma reproduktado en diversaj aparatoj.

Ekzemplo por MP3 Format-Shifting

Anstataŭigu YOUR_API_KEY per via unika API-ŝlosilo (trovebla sur via konto-paĝo de Yout.com) kaj anstataŭigu AUDIO_URL per la aŭda/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 formato-ŝanĝo

Sendu video/aŭdian URL al la Yout.com API por MP4-formatoŝanĝo. La API aŭtomate detektos la audio/videon kaj preparos ĝin por optimuma reproduktado en diversaj aparatoj.

Ekzemplo por MP4 Format-Shifting

Anstataŭigu YOUR_API_KEY per via unika API-ŝlosilo (trovebla sur via konto-paĝo de Yout.com) kaj anstataŭigu VIDEO_URL per la aŭda/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

La aŭda/video URL en bazo64. Kontrolu ĉiujn paĝojn, kiujn ni subtenas. Klaku ĉi tie

Ĉi tio estas uzata por eltondi la audio aŭ video kaj reprezentas la duan ĉe kiu vi volas ke la aŭd/video registrado komenciĝu. Vi povas sendi false por indiki ke ĝi devus komenci de la 0-a sekundo.

Ĉi tio estas uzata por eltondi la audio aŭ video kaj reprezentas la duan ĉe kiu vi volas ke la aŭd/video registrado finiĝos. Vi povas sendi <code>false</code> se vi ne volas tranĉi la aŭd-/videon.

La titolo sub kiu la audio/video estos registrita; ĝi ankaŭ estas uzata por nomi la generitan dosieron.

La nomo de la artisto sub kiu la dosiero estos registrita.

La kvalito ĉe kiu la sondosiero estos registrita. La disponeblaj kvalitoj estas 32k , 64k , 128k , 256k aŭ 320k .

La kvalito ĉe kiu la videodosiero estos registrita. La disponeblaj kvalitoj estas 144 , 240 , 360 , 480 , 720 (Por HD), 1080 (Por UHD), 2160 (Por 4k), aŭ 4320 (Por 8k).