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 Yout.com API-ზე 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 Yout.com API-ზე 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

აუდიო/ვიდეო URL base64-ში. შეამოწმეთ ყველა გვერდი, რომელსაც მხარს ვუჭერთ. დააწკაპუნეთ აქ

ეს გამოიყენება აუდიოს ან ვიდეოს მოსაჭრელად და წარმოადგენს მეორეს, როდესაც გსურთ დაიწყოთ აუდიო/ვიდეო ჩაწერა. თქვენ შეგიძლიათ გაგზავნოთ false რათა მიუთითოთ, რომ ის უნდა დაიწყოს 0 წამიდან.

ეს გამოიყენება აუდიოს ან ვიდეოს ამოსაჭრელად და წარმოადგენს მეორეს, როდესაც გსურთ დასრულდეს აუდიო/ვიდეო ჩანაწერი. თქვენ შეგიძლიათ გაგზავნოთ <code>false</code> , თუ არ გსურთ აუდიო/ვიდეოს ამოჭრა.

სათაური, რომლითაც ჩაიწერება აუდიო/ვიდეო; იგი ასევე გამოიყენება გენერირებული ფაილის დასასახელებლად.

მხატვრის სახელი, რომლის ქვეშაც ჩაიწერება ფაილი.

ხარისხი, რომლითაც ჩაიწერება აუდიო ფაილი. ხელმისაწვდომი თვისებებია 32k , 64k , 128k , 256k ან 320k .

ხარისხი, რომლითაც ვიდეო ფაილი ჩაიწერება. ხელმისაწვდომი ხარისხებია 144 , 240 , 360 , 480 , 720 (HD–ისთვის), 1080 (UHD–სთვის), 2160 (4k–სთვის) ან 4320 (8k–სთვის).