Guías y tutoriales

Configuración paso a paso para cada ruta de integración.

Inicio rápido

Tres pasos hasta tu primera transcripción:

1. Regístrate en subdownload.com/account y obtén 1 000 créditos gratis.
2. Copia tu clave API (empieza por sk_live_).
3. Llama a la API con tu clave en la cabecera 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));

// Nunca codifiques tu clave API en código cliente.
// Usa un proxy en tu propio backend.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

Autenticación

Todas las peticiones requieren un Bearer token en la cabecera Authorization:

Authorization: Bearer sk_live_xxxxx

• • Las claves API empiezan por sk_live_.
• • Las claves no expiran salvo revocación o regeneración manual.
• • Guarda las claves en variables de entorno — nunca en código cliente o repos públicos.
• • Gestiona las claves en subdownload.com/account.

Verifica una clave: GET /v1/verify (gratis, sin cargar créditos).

Configuración Claude (Desktop / Code)

Claude admite OAuth con Dynamic Client Registration — sin credenciales precreadas.

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

Claude abre un navegador para autorizar. Los tokens se refrescan automáticamente.

O usa una clave API estática (sin OAuth):

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

ChatGPT (GPT Actions / Custom Connectors)

ChatGPT usa clientes OAuth estáticos. Pasos:

1. Ve a tu cuenta → pestaña MCP / OAuth.
2. Copia Client ID y Client Secret.
3. En ChatGPT, agrega un Connector / Action con:
   • URL MCP: https://api.subdownload.com/mcp
   • Auth: OAuth con tus Client ID y Secret

OpenAI Agent Builder

Pega tu clave API directamente como método de autenticación (Bearer token). La URL del servidor es https://api.subdownload.com/mcp.