Τεκμηρίωση API

Το Yout.com API φιλοξενείται στο dvr.yout.com .

Πιστοποίηση

Για να αποκτήσετε πρόσβαση στο Yout.com API, πρέπει να συμπεριλάβετε το μοναδικό κλειδί API σας. Μπορείτε να αποκτήσετε ένα κλειδί API με την εγγραφή σας με τη διεύθυνση email σας. Θυμηθείτε να διατηρήσετε το κλειδί σας API εμπιστευτικό.

Ο έλεγχος ταυτότητας με το API γίνεται μέσω κεφαλίδων HTTP. Όλα τα αιτήματα απαιτούν μια κεφαλίδα εξουσιοδότησης που περιέχει το κλειδί API στο κλειδί μορφής: YOUR_API_KEY , όπου YOUR_API_KEY είναι το κλειδί που είναι διαθέσιμο στη σελίδα του λογαριασμού σας.

Για ασφάλεια, όλα τα αιτήματα πρέπει να αποστέλλονται μέσω κρυπτογραφημένης σύνδεσης HTTPS για την προστασία των δεδομένων σας κατά τη μετάδοση.

Αλλαγή μορφής MP3

Στείλτε διεύθυνση URL βίντεο/ήχου στο API Yout.com για αλλαγή μορφής 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 βίντεο/ήχου στο API Yout.com για αλλαγή μορφής 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

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