API құжаттамасы

API бағасын білу үшін мына жерді басыңыз

Soundc.com API интерфейсі soundc.com сайтында орналасқан.

Аутентификация

Soundc.com API интерфейсіне кіру үшін бірегей API кілтін қамтуыңыз керек. Электрондық пошта мекенжайыңызбен тіркелу арқылы API кілтін алуға болады. API кілтін құпия сақтауды ұмытпаңыз.

API көмегімен аутентификация HTTP тақырыптары арқылы өңделеді. Барлық сұраулар пішім кілтінде API кілтін қамтитын Авторизация тақырыбын қажет етеді: YOUR_API_KEY , мұнда YOUR_API_KEY есептік жазба бетінде қолжетімді кілт болып табылады.

Қауіпсіздік үшін барлық сұраулар тасымалдау кезінде деректеріңізді қорғау үшін шифрланған HTTPS қосылымы арқылы жіберілуі керек.

Download Endpoint

Extract media from any supported URL with a single synchronous request. No polling required.

POST https://api.soundc.com/api/download

Headers: Authorization: YOUR_API_KEY, Content-Type: application/json

import requests

headers = {
    "Authorization": "API_KEY",
    "Content-Type": "application/json"
}
r = requests.post(
    url="https://api.soundc.com/api/download",
    headers=headers,
    json={"url": "URL"}
)

if r.status_code == 200:
    data = r.json()
    for item in data.get("items", []):
        print(f"Type: {item['type']}, URL: {item['url']}")
else:
    print(f"Error: {r.status_code} - {r.text}")

const axios = require('axios');

async function download() {
    try {
        const response = await axios.post(
            'https://api.soundc.com/api/download',
            { url: "URL" },
            { headers: { "Authorization": "API_KEY", "Content-Type": "application/json" } }
        );

        for (const item of response.data.items) {
            console.log(`Type: ${item.type}, URL: ${item.url}`);
        }
    } catch (error) {
        console.error(`Error: ${error.response?.status} - ${error.response?.data}`);
    }
}

download();

<?php

$ch = curl_init("https://api.soundc.com/api/download");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["url" => "URL"]));

$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($statusCode === 200) {
    $data = json_decode($response, true);
    foreach ($data['items'] as $item) {
        echo "Type: {$item['type']}, URL: {$item['url']}\n";
    }
} else {
    echo "Error: $statusCode - $response\n";
}

?>

curl -X POST "https://api.soundc.com/api/download" \
  -H "Authorization: API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "URL"}'

Response

{
    "success": true,
    "items": [
        {
            "url": "https://...",
            "type": "video",
            "thumbnail": "https://...",
            "mime_type": "video/mp4",
            "site": "tiktok",
            "title": "Video title"
        }
    ]
}

Conversion Endpoints

Convert media to different formats. Returns a binary file stream.

All conversion endpoints are at https://api.soundc.com.

Request body (JSON):

Example: Convert to MP3

import requests

headers = {
    "Authorization": "API_KEY",
    "Content-Type": "application/json"
}

r = requests.post(
    url="https://api.soundc.com/api/convert/mp3",
    headers=headers,
    json={
        "url": "URL",
        "options": {
            "audio_quality": "192",
            "start_time": 10,
            "end_time": 45
        }
    },
    stream=True
)

if r.status_code == 200:
    with open("output.mp3", "wb") as f:
        for chunk in r.iter_content(chunk_size=8192):
            f.write(chunk)
    print("Downloaded output.mp3")
else:
    print(f"Error: {r.status_code} - {r.text}")

curl -X POST "https://api.soundc.com/api/convert/mp3" \
  -H "Authorization: API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "URL", "options": {"audio_quality": "192"}}' \
  --output output.mp3

Error Handling

All errors return a JSON response with an error field:

// 400 Bad Request
{"error": "Missing URL"}

// 401 Unauthorized
{"error": "Invalid API token"}

// 402 Payment Required
{"error": "Insufficient credits"}