Guias e tutoriais

Configuração passo a passo para cada caminho de integração.

Início rápido

Três passos até a sua primeira transcrição:

1. Cadastre-se em subdownload.com/account para obter 1.000 créditos grátis.
2. Copie sua API Key (começa com sk_live_).
3. Chame a API com a key no cabeçalho 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 coloque sua API Key no código do cliente.
// Use um proxy em seu próprio backend.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

Autenticação

Toda requisição da API precisa de um Bearer token no cabeçalho Authorization:

Authorization: Bearer sk_live_xxxxx

• • API Keys começam com sk_live_.
• • Keys nunca expiram a menos que sejam revogadas ou regeneradas manualmente.
• • Armazene as keys em variáveis de ambiente — nunca em código cliente ou repositórios públicos.
• • Gerencie as keys em subdownload.com/account.

Verifique uma key: GET /v1/verify (grátis, sem cobrança de créditos).

Claude (Desktop / Code) — configuração

O Claude suporta OAuth com Dynamic Client Registration — sem credenciais pré-criadas.

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

O Claude abre um navegador para autorizar. Tokens são renovados automaticamente.

Ou use uma API Key estática (sem OAuth):

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

ChatGPT (GPT Actions / Custom Connectors)

O ChatGPT usa clientes OAuth estáticos. Passos:

1. Acesse sua conta → aba MCP / OAuth.
2. Copie Client ID e Client Secret.
3. No ChatGPT, adicione um Connector / Action com:
   • URL MCP: https://api.subdownload.com/mcp
   • Auth: OAuth com seus Client ID e Secret

OpenAI Agent Builder

Cole sua API Key diretamente como método de autenticação (Bearer token). A URL do servidor é https://api.subdownload.com/mcp.