API дакументацыя

API Yout.com размешчаны на dvr.yout.com .

Аўтэнтыфікацыя

Каб атрымаць доступ да API Yout.com, вы павінны ўключыць свой унікальны ключ API. Вы можаце атрымаць ключ API, зарэгістраваўшыся са сваім адрасам электроннай пошты. Калі ласка, не забывайце захоўваць канфідэнцыяльнасць вашага ключа API.

Аўтэнтыфікацыя з дапамогай API ажыццяўляецца праз загалоўкі HTTP. Для ўсіх запытаў патрабуецца загаловак аўтарызацыі, які змяшчае ваш ключ API у ключы фармату: YOUR_API_KEY , дзе YOUR_API_KEY - ключ, даступны на старонцы вашага ўліковага запісу.

У мэтах бяспекі ўсе запыты павінны адпраўляцца праз зашыфраванае злучэнне HTTPS, каб абараніць вашы даныя падчас перадачы.

Змена фармату mp3

Адпраўце URL відэа/аўдыё ў API Yout.com для змены фармату MP3. 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

Адпраўце URL відэа/аўдыё ў API Yout.com для змены фармату MP4. 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)

URL-адрас аўдыя/відэа ў base64. Праверце ўсе старонкі, якія мы падтрымліваем. Націсніце тут

start_time

int

Гэта выкарыстоўваецца для абрэзкі аўдыя або відэа і ўяўляе секунду, з якой вы хочаце пачаць запіс аўдыё/відэа. Вы можаце адправіць false , каб паказаць, што ён павінен пачынацца з 0-й секунды.

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).