اسناد 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 URL ویدئو/صوتی را به API Yout.com ارسال کنید. API به طور خودکار صدا/تصویر را شناسایی کرده و آن را برای پخش بهینه در دستگاه های مختلف آماده می کند.

مثالی برای تغییر فرمت MP3

YOUR_API_KEY با کلید API منحصربفرد خود (که در صفحه حساب Yout.com شما یافت می شود) جایگزین کنید و URL صوتی/تصویری را جایگزین AUDIO_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 URL ویدیویی/صوتی را به API Yout.com ارسال کنید. API به طور خودکار صدا/تصویر را شناسایی کرده و آن را برای پخش بهینه در دستگاه های مختلف آماده می کند.

مثال برای MP4 Format-Shifting

YOUR_API_KEY با کلید API منحصر به فرد خود (که در صفحه حساب Yout.com شما یافت می شود) جایگزین کنید و URL صوتی/تصویری را جایگزین VIDEO_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 ارسال کنید تا نشان دهید باید از ثانیه صفر شروع شود.

این برای برش صدا یا ویدیو استفاده می شود و نشان دهنده دومین زمانی است که می خواهید ضبط صوتی/تصویری پایان یابد. اگر نمی‌خواهید صدا/تصویر را کوتاه کنید، می‌توانید <code>false</code> ارسال کنید.

عنوانی که فایل صوتی/تصویری تحت آن ضبط خواهد شد. همچنین برای نامگذاری فایل تولید شده استفاده می شود.

نام هنرمندی که فایل تحت آن ثبت خواهد شد.

کیفیتی که فایل صوتی با آن ضبط خواهد شد. کیفیت های موجود عبارتند از 32k , 64k , 128k , 256k یا 320k .

کیفیتی که فایل ویدئویی با آن ضبط خواهد شد. کیفیت های موجود عبارتند از: 144 ، 240 ، 360 ، 480 ، 720 (برای HD)، 1080 (برای UHD)، 2160 (برای 4k)، یا 4320 (برای 8k).