Dokumentacja API

Aby zapoznać się z cennikiem API , kliknij tutaj

API Yout.com jest hostowane na dvr.yout.com .

Uwierzytelnianie

Aby uzyskać dostęp do Yout.com API, musisz dołączyć swój unikalny klucz API. Możesz uzyskać klucz API, rejestrując się za pomocą swojego adresu e-mail. Pamiętaj, aby zachować swój klucz API w tajemnicy.

Uwierzytelnianie za pomocą API jest obsługiwane przez nagłówki HTTP. Wszystkie żądania wymagają nagłówka Authorization zawierającego klucz API w formacie key: YOUR_API_KEY , gdzie YOUR_API_KEY to klucz dostępny na stronie konta.

Ze względów bezpieczeństwa wszystkie żądania muszą być wysyłane za pośrednictwem szyfrowanego połączenia HTTPS, aby chronić Twoje dane podczas transmisji.

Zmiana formatu MP3

Wyślij adres URL wideo/audio do API Yout.com w celu zmiany formatu MP3. API automatycznie wykryje audio/wideo i przygotuje je do optymalnego odtwarzania na różnych urządzeniach.

Przykład zmiany formatu MP3

Zastąp YOUR_API_KEY swoim unikalnym kluczem API (znajdującym się na stronie konta Yout.com) i zastąp AUDIO_URL adresem URL audio/wideo:

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}"

Zmiana formatu MP4

Wyślij adres URL wideo/audio do API Yout.com w celu zmiany formatu MP4. API automatycznie wykryje audio/wideo i przygotuje je do optymalnego odtwarzania na różnych urządzeniach.

Przykład zmiany formatu MP4

Zastąp YOUR_API_KEY swoim unikalnym kluczem API (znajdującym się na stronie konta Yout.com) i zastąp VIDEO_URL adresem URL audio/wideo:

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)

Adres URL audio/wideo w base64. Sprawdź wszystkie strony, które obsługujemy. Kliknij tutaj

start_time

int

Służy do przycinania dźwięku lub obrazu i reprezentuje sekundę, od której chcesz rozpocząć nagrywanie dźwięku/obrazu. Możesz wysłać false , aby wskazać, że powinno się rozpocząć od 0 sekundy.

end_time

int / bool (false)

Służy do przycinania dźwięku lub obrazu i reprezentuje sekundę, w której chcesz zakończyć nagrywanie dźwięku/obrazu. Możesz wysłać <code>false</code> jeśli nie chcesz przycinać dźwięku/obrazu.

title

string (required)

Tytuł, pod którym zostanie nagrany dźwięk/obraz. Służy również do nazwania wygenerowanego pliku.

artist

string

Nazwisko artysty, pod którym plik zostanie nagrany.

audio_quality

string

Jakość, w jakiej plik audio zostanie nagrany. Dostępne jakości to 32k , 64k , 128k , 256k lub 320k .

video_quality

string

Jakość, w jakiej plik wideo zostanie nagrany. Dostępne jakości to 144 , 240 , 360 , 480 , 720 (dla HD), 1080 (dla UHD), 2160 (dla 4k) lub 4320 (dla 8k).