API-Dokumentation

Klicken Sie hier, um die API-Preise anzuzeigen

Die Yout.com-API wird unter dvr.yout.com gehostet.

Authentifizierung

Um auf die Yout.com-API zuzugreifen, müssen Sie Ihren eindeutigen API-Schlüssel angeben. Sie können einen API-Schlüssel erhalten, indem Sie sich mit Ihrer E-Mail-Adresse anmelden. Bitte denken Sie daran, Ihren API-Schlüssel vertraulich zu behandeln.

Die Authentifizierung mit der API erfolgt über HTTP-Header. Alle Anfragen erfordern einen Autorisierungsheader, der Ihren API-Schlüssel im Format Schlüssel: YOUR_API_KEY enthält, wobei YOUR_API_KEY der auf Ihrer Kontoseite verfügbare Schlüssel ist.

Aus Sicherheitsgründen müssen alle Anfragen über eine verschlüsselte HTTPS-Verbindung gesendet werden, um Ihre Daten während der Übertragung zu schützen.

MP3-Formatverschiebung

Senden Sie die Video-/Audio-URL an die Yout.com-API zur MP3-Formatverschiebung. Die API erkennt das Audio/Video automatisch und bereitet es für die optimale Wiedergabe auf verschiedenen Geräten vor.

Beispiel für MP3 Format-Shifting

Ersetzen Sie YOUR_API_KEY durch Ihren eindeutigen API-Schlüssel (zu finden auf Ihrer Yout.com-Kontoseite) und ersetzen Sie AUDIO_URL durch die Audio-/Video-URL:

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

MP4-Formatverschiebung

Senden Sie die Video-/Audio-URL an die Yout.com-API zur MP4-Formatumwandlung. Die API erkennt das Audio/Video automatisch und bereitet es für die optimale Wiedergabe auf verschiedenen Geräten vor.

Beispiel für MP4 Format-Shifting

Ersetzen Sie YOUR_API_KEY durch Ihren eindeutigen API-Schlüssel (zu finden auf Ihrer Yout.com-Kontoseite) und ersetzen Sie VIDEO_URL durch die Audio-/Video-URL:

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)

Die Audio-/Video-URL in Base64. Sehen Sie sich alle von uns unterstützten Seiten an. Klicken Sie hier

start_time

int

Dies wird zum Trimmen des Audio- oder Videomaterials verwendet und stellt die Sekunde dar, bei der die Audio-/Videoaufnahme beginnen soll. Sie können false senden, um anzugeben, dass die Aufnahme bei der 0. Sekunde beginnen soll.

end_time

int / bool (false)

Dies wird zum Trimmen des Audio- oder Videosignals verwendet und stellt die Sekunde dar, bei der die Audio-/Videoaufnahme enden soll. Sie können <code>false</code> senden, wenn Sie das Audio-/Videosignal nicht trimmen möchten.

title

string (required)

Der Titel, unter dem das Audio/Video aufgezeichnet wird; er wird auch zum Benennen der generierten Datei verwendet.

artist

string

Der Name des Künstlers, unter dem die Datei aufgezeichnet wird.

audio_quality

string

Die Qualität, in der die Audiodatei aufgezeichnet wird. Die verfügbaren Qualitäten sind 32k , 64k , 128k , 256k oder 320k .

video_quality

string

Die Qualität, in der die Videodatei aufgezeichnet wird. Die verfügbaren Qualitäten sind 144 , 240 , 360 , 480 , 720 (für HD), 1080 (für UHD), 2160 (für 4k) oder 4320 (für 8k).