Documentació de l'API

Per obtenir el preu de l'API, feu clic aquí

L'API de Yout.com està allotjada a dvr.yout.com .

Autenticació

Per accedir a l'API de Yout.com, heu d'incloure la vostra clau d'API única. Podeu obtenir una clau API registrant-vos amb la vostra adreça de correu electrònic. Recordeu mantenir la vostra clau de l'API confidencial.

L'autenticació amb l'API es gestiona mitjançant capçaleres HTTP. Totes les sol·licituds requereixen una capçalera d'autorització que contingui la vostra clau API amb la clau de format: YOUR_API_KEY , on YOUR_API_KEY és la clau disponible a la pàgina del vostre compte.

Per seguretat, totes les sol·licituds s'han d'enviar mitjançant una connexió HTTPS xifrada per protegir les vostres dades durant la transmissió.

Canvi de format MP3

Envieu l'URL de vídeo/àudio a l'API de Yout.com per canviar el format MP3. L'API detectarà automàticament l'àudio/vídeo i el prepararà per a una reproducció òptima en diversos dispositius.

Exemple de canvi de format MP3

Substituïu YOUR_API_KEY per la vostra clau API única (que es troba a la pàgina del vostre compte de Yout.com) i substituïu AUDIO_URL per l'URL d'àudio/vídeo:

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

Canvi de format MP4

Envieu l'URL de vídeo/àudio a l'API de Yout.com per canviar el format MP4. L'API detectarà automàticament l'àudio/vídeo i el prepararà per a una reproducció òptima en diversos dispositius.

Exemple de canvi de format MP4

Substituïu YOUR_API_KEY per la vostra clau API única (que es troba a la pàgina del vostre compte de Yout.com) i substituïu VIDEO_URL per l'URL d'àudio/vídeo:

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)

L'URL d'àudio/vídeo a base64. Consulta totes les pàgines que donem suport. Feu clic aquí

start_time

int

S'utilitza per retallar l'àudio o el vídeo i representa el segon en què voleu que comenci la gravació d'àudio/vídeo. Podeu enviar false per indicar que hauria de començar des del segon 0.

end_time

int / bool (false)

S'utilitza per retallar l'àudio o el vídeo i representa el segon en què voleu que finalitzi la gravació d'àudio/vídeo. Podeu enviar <code>false</code> si no voleu retallar l'àudio/vídeo.

title

string (required)

El títol sota el qual s'enregistrarà l'àudio/vídeo; també s'utilitza per anomenar el fitxer generat.

artist

string

Nom de l'artista amb el qual s'enregistrarà el fitxer.

audio_quality

string

La qualitat amb què s'enregistrarà el fitxer d'àudio. Les qualitats disponibles són 32k , 64k , 128k , 256k o 320k .

video_quality

string

La qualitat amb què es gravarà el fitxer de vídeo. Les qualitats disponibles són 144 , 240 , 360 , 480 , 720 (per a HD), 1080 (per a UHD), 2160 (per a 4k) o 4320 (per a 8k).