Руководства

Пошаговая настройка для каждого пути интеграции.

Быстрый старт

Три шага до первого транскрипта:

1. Зарегистрируйтесь на subdownload.com/account и получите 1 000 бесплатных кредитов.
2. Скопируйте API-ключ (начинается с sk_live_).
3. Вызовите API, указав ключ в заголовке Authorization.

curl -H "Authorization: Bearer sk_live_xxx" \
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ"

import requests

API_KEY = "sk_live_xxx"
BASE = "https://api.subdownload.com/v1"

r = requests.get(
    f"{BASE}/youtube/transcript",
    params={"video_id": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
r.raise_for_status()
data = r.json()
print(data["data"]["text"][:200])

const API_KEY = "sk_live_xxx";

const res = await fetch(
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ",
  { headers: { Authorization: "Bearer " + API_KEY } }
);
if (!res.ok) throw new Error("HTTP " + res.status);
const data = await res.json();
console.log(data.data.text.slice(0, 200));

// Никогда не зашивайте API-ключ в клиентский код.
// Делайте прокси через свой бэкенд.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

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

Все запросы требуют Bearer-токен в заголовке Authorization:

Authorization: Bearer sk_live_xxxxx

• • API-ключи начинаются с sk_live_.
• • Ключи не истекают, пока вы не отзовёте или не перегенерируете их.
• • Храните ключи в переменных окружения — никогда в клиентском коде или публичных репозиториях.
• • Управление ключами на subdownload.com/account.

Проверить ключ: GET /v1/verify (бесплатно, без списания кредитов).

Настройка Claude (Desktop / Code)

Claude поддерживает OAuth с Dynamic Client Registration — заранее создавать учётные данные не нужно.

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp"
    }
  }
}

Claude откроет браузер для авторизации. Токены обновляются автоматически.

Или используйте статический API-ключ (без OAuth):

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_xxx" }
    }
  }
}

ChatGPT (GPT Actions / Custom Connectors)

ChatGPT использует статические OAuth-клиенты. Шаги:

1. Перейдите в аккаунт → вкладка MCP / OAuth.
2. Скопируйте Client ID и Client Secret.
3. В ChatGPT добавьте новый Connector / Action:
   • MCP URL: https://api.subdownload.com/mcp
   • Auth: OAuth с вашими Client ID и Secret

OpenAI Agent Builder

Вставьте API-ключ как метод аутентификации (Bearer token). URL сервера — https://api.subdownload.com/mcp.