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