API документација

Yout.com API е хостиран на dvr.yout.com .

Автентикација

За да пристапите до Yout.com API, мора да го вклучите вашиот единствен API клуч. Можете да добиете клуч API со пријавување со вашата адреса за е-пошта. Ве молиме не заборавајте да го чувате вашиот клуч API доверлив.

Автентикацијата со API се постапува преку HTTP заглавија. Сите барања бараат заглавие за авторизација што го содржи вашиот API клуч во клучот за формат: YOUR_API_KEY , каде што YOUR_API_KEY е клучот достапен на страницата на вашата сметка.

За безбедност, сите барања мора да се испратат преку шифрирана HTTPS конекција за да се заштитат вашите податоци за време на преносот.

Менување на формат MP3

Испратете URL-адреса на видео/аудио до API-то на Yout.com за менување на форматот MP3. API автоматски ќе го открие аудио/видеото и ќе го подготви за оптимална репродукција на различни уреди.

Пример за MP3 Format-Shifting

Заменете го 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 Format-Shifting

Заменете го 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).