Tài liệu API

API Yout.com được lưu trữ tại dvr.yout.com .

Xác thực

Để truy cập API Yout.com, bạn phải bao gồm khóa API duy nhất của mình. Bạn có thể lấy khóa API bằng cách đăng ký bằng địa chỉ email của mình. Hãy nhớ giữ bí mật khóa API của bạn.

Xác thực bằng API được xử lý thông qua tiêu đề HTTP. Tất cả các yêu cầu đều yêu cầu tiêu đề Ủy quyền có chứa khóa API của bạn theo định dạng khóa: YOUR_API_KEY , trong đó YOUR_API_KEY là khóa có sẵn trên trang tài khoản của bạn.

Vì lý do bảo mật, mọi yêu cầu phải được gửi qua kết nối HTTPS được mã hóa để bảo vệ dữ liệu của bạn trong quá trình truyền tải.

Chuyển đổi định dạng MP3

Gửi URL video/âm thanh đến API Yout.com để chuyển đổi định dạng MP3. API sẽ tự động phát hiện âm thanh/video và chuẩn bị để phát lại tối ưu trên nhiều thiết bị khác nhau.

Ví dụ về Chuyển đổi định dạng MP3

Thay thế YOUR_API_KEY bằng khóa API duy nhất của bạn (tìm thấy trên trang tài khoản Yout.com của bạn) và thay thế AUDIO_URL bằng URL âm thanh/video:

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

Chuyển đổi định dạng MP4

Gửi URL video/âm thanh đến API Yout.com để chuyển đổi định dạng MP4. API sẽ tự động phát hiện âm thanh/video và chuẩn bị để phát lại tối ưu trên nhiều thiết bị khác nhau.

Ví dụ về Chuyển đổi định dạng MP4

Thay thế YOUR_API_KEY bằng khóa API duy nhất của bạn (tìm thấy trên trang tài khoản Yout.com của bạn) và thay thế VIDEO_URL bằng URL âm thanh/video:

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 âm thanh/video trong base64. Kiểm tra tất cả các trang chúng tôi hỗ trợ. Nhấp vào đây

start_time

int

Điều này được sử dụng để cắt âm thanh hoặc video và biểu thị giây mà bạn muốn bản ghi âm thanh/video bắt đầu. Bạn có thể gửi false để chỉ ra rằng nó sẽ bắt đầu từ giây thứ 0.

end_time

int / bool (false)

Được sử dụng để cắt âm thanh hoặc video và biểu thị giây mà bạn muốn bản ghi âm thanh/video kết thúc. Bạn có thể gửi <code>false</code> nếu bạn không muốn cắt âm thanh/video.

title

string (required)

Tiêu đề mà âm thanh/video sẽ được ghi lại; tiêu đề này cũng được dùng để đặt tên cho tệp được tạo.

artist

string

Tên nghệ sĩ sẽ được sử dụng để ghi tệp tin.

audio_quality

string

Chất lượng mà tệp âm thanh sẽ được ghi lại. Các chất lượng có sẵn là 32k , 64k , 128k , 256k hoặc 320k .

video_quality

string

Chất lượng mà tệp video sẽ được ghi lại. Các chất lượng có sẵn là 144 , 240 , 360 , 480 , 720 (Đối với HD), 1080 (Đối với UHD), 2160 (Đối với 4k) hoặc 4320 (Đối với 8k).