Anleitungen & Tutorials

Schritt-für-Schritt-Einrichtung für jeden Integrationsweg.

Schnellstart

Drei Schritte bis zu deinem ersten Transkript:

1. Registrieren auf subdownload.com/account für 1.000 kostenlose Credits.
2. Kopiere deinen API-Key (beginnt mit sk_live_).
3. Rufe die API mit deinem Key im Authorization-Header auf.

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));

// Niemals den API-Key im Client-Code fest einbauen.
// Stattdessen über dein eigenes Backend proxyen.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

Authentifizierung

Alle API-Anfragen benötigen ein Bearer-Token im Authorization-Header:

Authorization: Bearer sk_live_xxxxx

• • API-Keys beginnen mit sk_live_.
• • Keys laufen nicht ab, außer sie werden manuell widerrufen oder neu generiert.
• • Keys in Umgebungsvariablen speichern — niemals im Client-Code oder in öffentlichen Repos.
• • Keys verwalten unter subdownload.com/account.

Key prüfen: GET /v1/verify (kostenlos, keine Credits).

Claude (Desktop / Code) einrichten

Claude unterstützt OAuth mit Dynamic Client Registration — keine vorab erstellten Credentials nötig.

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

Claude öffnet einen Browser zur Autorisierung. Tokens werden automatisch aktualisiert.

Oder einen statischen API-Key verwenden (kein OAuth):

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

ChatGPT (GPT Actions / Custom Connectors)

ChatGPT nutzt statische OAuth-Clients. Schritte:

1. Gehe zu deinem Konto → Tab MCP / OAuth.
2. Kopiere Client ID und Client Secret.
3. In ChatGPT einen neuen Connector / eine Action hinzufügen mit:
   • MCP-URL: https://api.subdownload.com/mcp
   • Auth: OAuth mit deinen Client ID & Secret

OpenAI Agent Builder

Füge deinen API-Key direkt als Authentifizierungsmethode ein (Bearer-Token). Die Server-URL ist https://api.subdownload.com/mcp.