Guides et tutoriels

Configuration pas à pas pour chaque intégration.

Démarrage rapide

Trois étapes pour votre première transcription :

1. Inscrivez-vous sur subdownload.com/account pour obtenir 1 000 crédits gratuits.
2. Copiez votre clé API (commence par sk_live_).
3. Appelez l'API avec la clé dans l'en-tête 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));

// Ne mettez jamais votre clé API en dur côté client.
// Passez par un proxy dans votre propre backend.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

Authentification

Toutes les requêtes exigent un Bearer token dans l'en-tête Authorization :

Authorization: Bearer sk_live_xxxxx

• • Les clés API commencent par sk_live_.
• • Les clés n'expirent pas sauf révocation ou régénération manuelle.
• • Stockez les clés dans des variables d'environnement — jamais côté client ou dans un dépôt public.
• • Gérez vos clés sur subdownload.com/account.

Vérifiez qu'une clé fonctionne : GET /v1/verify (gratuit, sans crédits facturés).

Configuration Claude (Desktop / Code)

Claude prend en charge OAuth avec Dynamic Client Registration — aucune création d'identifiants requise.

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

Claude ouvre un navigateur pour autoriser. Les tokens sont rafraîchis automatiquement.

Ou utilisez une clé API statique (sans OAuth) :

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

ChatGPT (GPT Actions / Custom Connectors)

ChatGPT utilise des clients OAuth statiques. Étapes :

1. Allez sur votre compte → onglet MCP / OAuth.
2. Copiez Client ID et Client Secret.
3. Dans ChatGPT, ajoutez un Connector / Action avec :
   • URL MCP : https://api.subdownload.com/mcp
   • Auth : OAuth avec vos Client ID et Secret

OpenAI Agent Builder

Collez directement votre clé API comme méthode d'authentification (Bearer token). L'URL du serveur est https://api.subdownload.com/mcp.