API құжаттамасы

Yout.com API dvr.yout.com сайтында орналастырылған.

Аутентификация

Yout.com API интерфейсіне кіру үшін бірегей API кілтін қамтуыңыз керек. Электрондық пошта мекенжайыңызбен тіркелу арқылы API кілтін алуға болады. API кілтін құпия сақтауды ұмытпаңыз.

API көмегімен аутентификация HTTP тақырыптары арқылы өңделеді. Барлық сұраулар пішім кілтінде API кілтін қамтитын Авторизация тақырыбын қажет етеді: YOUR_API_KEY , мұнда YOUR_API_KEY есептік жазба бетінде қолжетімді кілт болып табылады.

Қауіпсіздік үшін барлық сұраулар тасымалдау кезінде деректеріңізді қорғау үшін шифрланған HTTPS қосылымы арқылы жіберілуі керек.

MP3 форматын ауыстыру

MP3 пішімін ауыстыру үшін Yout.com API мекенжайына бейне/аудио URL мекенжайын жіберіңіз. API аудио/бейнені автоматты түрде анықтайды және оны әртүрлі құрылғыларда оңтайлы ойнатуға дайындайды.

MP3 форматын ауыстыруға мысал

YOUR_API_KEY бірегей API кілтімен (Yout.com тіркелгі бетінде табуға болады) ауыстырыңыз және AUDIO_URL мекенжайын аудио/бейне 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 форматын ауыстыру

MP4 пішімін ауыстыру үшін Yout.com API мекенжайына бейне/аудио URL мекенжайын жіберіңіз. API аудио/бейнені автоматты түрде анықтайды және оны әртүрлі құрылғыларда оңтайлы ойнатуға дайындайды.

MP4 форматын ауыстыру мысалы

YOUR_API_KEY бірегей API кілтімен (Yout.com тіркелгі бетінде табылған) ауыстырыңыз және VIDEO_URL мекенжайын аудио/бейне 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)

base64 ішіндегі аудио/бейне URL мекенжайы. Біз қолдайтын барлық беттерді тексеріңіз. Мында басыңыз

start_time

int

Бұл дыбысты немесе бейнені кесу үшін пайдаланылады және аудио/бейне жазбасы басталатын секундты білдіреді. 0 секундтан басталуы керек екенін көрсету үшін false жібере аласыз.

end_time

int / bool (false)

Бұл дыбысты немесе бейнені кесу үшін пайдаланылады және аудио/бейне жазбаның аяқталуын қалайтын секундты көрсетеді. Аудио/бейнені кескіңіз келмесе, <code>false</code> жібере аласыз.

title

string (required)

Аудио/бейне жазылатын тақырып; ол жасалған файлды атау үшін де қолданылады.

artist

string

Файл жазылатын орындаушының аты.

audio_quality

string

Аудио файл жазылатын сапа. Қол жетімді сапалар: 32k , 64k , 128k , 256k немесе 320k .

video_quality

string

Бейне файл жазылатын сапа. Қол жетімді сапалар: 144 , 240 , 360 , 480 , 720 (HD үшін), 1080 (UHD үшін), 2160 (4k үшін) немесе 4320 (8k үшін).