ҳуҷҷатҳои 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"}
video_url = base64.b64encode("VIDEO_URL".encode()).decode()
r = requests.post(
    url="https://dvr.yout.com/mp3",
    headers=headers,
    data={
        "video_url": video_url,
        "start_time": False,
        "end_time": False,
        "title": "Hello world",
        "artist": "Hello world",
        "audio_quality": '128k',
    }
)

if r.status_code == 200:
    with open("audio.mp3", "wb") as fd:
        for chunk in r.iter_content(chunk_size=128):
            fd.write(chunk)
else:
    print(r.status_code)
    print(r.text)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const videoUrl = Buffer.from("VIDEO_URL").toString('base64');

const data = {
  video_url: videoUrl,
  start_time: false,
  end_time: false,
  title: "Hello world",
  artist: "Hello world",
  audio_quality: "128k"
};

axios
  .post("https://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",
    "artist" => "Hello world",
    "audio_quality" => "128k",
    "format" => "mp3"
];

$postData = http_build_query($data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://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);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    file_put_contents("audio.mp3", $response);
    echo "✅ audio.mp3";
} else {
    echo "❌ $httpCode\n";
    echo $response;
}
?>

curl -L -X POST "https://dvr.yout.com/mp3" \
    -H "Authorization: API_KEY" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "video_url=$(echo -n 'VIDEO_URL' | base64)" \
    --data-urlencode "start_time=false" \
    --data-urlencode "end_time=false" \
    --data-urlencode "title=Hello world" \
    --data-urlencode "artist=Hello world" \
    --data-urlencode "audio_quality=128k" \
    --data-urlencode "format=mp3" \
    --output "audio.mp3" --silent --show-error --write-out "\nHTTP_STATUS=%{http_code}"

Гузариши формати 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".encode()).decode()
r = requests.post(
    url="https://dvr.yout.com/mp4",
    headers=headers,
    data={
        "video_url": video_url,
        "start_time": False,
        "end_time": False,
        "title": "hello world",
        "video_quality": 720
    }
)

if r.status_code == 200:
    with open("video.mp4", "wb") as fd:
        for chunk in r.iter_content(chunk_size=128):
            fd.write(chunk)
else:
    print(r.status_code)
    print(r.text)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const videoUrl = Buffer.from("VIDEO_URL").toString('base64');

const data = {
  video_url: videoUrl,
  start_time: false,
  end_time: false,
  title" "hello world",
  video_quality: 720
};

axios
  .post("https://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, "https://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_put_contents("video.mp4", $response);
    echo "✅ video.mp4";
} else {
    echo "❌ $httpCode\n";
    echo $response;
}
?>

curl -L -X POST "https://dvr.yout.com/mp4" \
     -H "Authorization: API_KEY" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     --data-urlencode "video_url=$(echo -n 'VIDEO_URL' | base64)" \
     --data-urlencode "start_time=false" \
     --data-urlencode "end_time=false" \
     --data-urlencode "title=hello world" \
     --data-urlencode "video_quality=720" \
     --data-urlencode "format=mp4" \
     --output video.mp4 --silent --show-error --write-out "\nHTTP_STATUS=%{http_code}"

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 (Барои 8к) мебошанд.