API dokumentācija

Yout.com API ir mitināts vietnē dvr.yout.com .

Autentifikācija

Lai piekļūtu Yout.com API, ir jāiekļauj sava unikālā API atslēga. Jūs varat iegūt API atslēgu, reģistrējoties ar savu e-pasta adresi. Lūdzu, ņemiet vērā, ka API atslēga ir konfidenciāla.

Autentifikācija ar API tiek veikta, izmantojot HTTP galvenes. Visiem pieprasījumiem ir nepieciešama autorizācijas galvene, kurā ir ietverta jūsu API atslēga šādā formāta atslēgā: YOUR_API_KEY , kur YOUR_API_KEY ir jūsu konta lapā pieejamā atslēga.

Drošības nolūkos visi pieprasījumi ir jānosūta, izmantojot šifrētu HTTPS savienojumu, lai aizsargātu jūsu datus pārsūtīšanas laikā.

MP3 formāta maiņa

Nosūtiet video/audio URL uz Yout.com API MP3 formāta maiņai. API automātiski noteiks audio/video un sagatavos to optimālai atskaņošanai dažādās ierīcēs.

MP3 formāta maiņas piemērs

Aizstājiet YOUR_API_KEY ar savu unikālo API atslēgu (atrodu jūsu Yout.com konta lapā) un aizstājiet AUDIO_URL ar audio/video 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 formāta maiņa

Nosūtiet video/audio URL uz Yout.com API MP4 formāta maiņai. API automātiski noteiks audio/video un sagatavos to optimālai atskaņošanai dažādās ierīcēs.

MP4 formāta maiņas piemērs

Aizstājiet YOUR_API_KEY ar savu unikālo API atslēgu (atrodu jūsu Yout.com konta lapā) un aizstājiet VIDEO_URL ar audio/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

video_url

string (required)

Audio/video URL base64. Pārbaudiet visas mūsu atbalstītās lapas. Noklikšķiniet šeit

start_time

int

Tas tiek izmantots, lai apgrieztu audio vai video, un apzīmē sekundi, kurā vēlaties sākt audio/video ierakstīšanu. Varat nosūtīt false lai norādītu, ka tam jāsākas no 0. sekundes.

end_time

int / bool (false)

Tas tiek izmantots, lai apgrieztu audio vai video, un tas apzīmē sekundi, kurā vēlaties beigt audio/video ierakstīšanu. Varat nosūtīt <code>false</code> , ja nevēlaties apgriezt audio/video.

title

string (required)

Virsraksts, ar kuru audio/video tiks ierakstīts; to izmanto arī, lai nosauktu ģenerēto failu.

artist

string

Mākslinieka vārds, ar kuru fails tiks ierakstīts.

audio_quality

string

Kvalitāte, kādā audio fails tiks ierakstīts. Pieejamās kvalitātes ir 32k , 64k , 128k , 256k vai 320k .

video_quality

string

Kvalitāte, kādā tiks ierakstīts video fails. Pieejamās kvalitātes ir 144 , 240 , 360 , 480 , 720 (HD), 1080 (UHD), 2160 (4k) vai 4320 (8k).