transcriptd

API de transcripción de YouTube para agentes de IA: pago por transcripción exitosa mediante x402 (USDC en Base); los videos fallidos nunca se cobran

Documentación

transcriptd

API de transcripciones de YouTube para agentes de IA — paga por transcripción exitosa mediante x402 (USDC en Base) o en la Apify Store.

La garantía: solo se te cobra cuando se entrega una transcripción. Sin subtítulos, video privado/eliminado o un fallo de nuestro lado → error HTTP → sin cargo.

Endpoints

URL base: https://transcriptd.fly.dev

EndpointPrecioDevuelve
GET /transcript?video={url|id}&format={json|text|srt}&lang=en$0.005segmentos de subtítulos con marcas de tiempo + texto limpio
GET /metadata?video={url|id}$0.002título, canal, duración, idiomas de subtítulos disponibles
GET / , GET /healthzgratisdocumentación del servicio / salud + versión del extractor

Sin clave API, sin cuenta, sin suscripción — el pago ES la autenticación (x402, USDC en Base, sin gas para el pagador).

Inicio rápido (agente / script)

# pip install "x402[httpx,evm]" eth-account
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402_httpx_transport
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import ExactEvmScheme
import httpx, asyncio

async def main():
    xc = x402Client()
    xc.register("eip155:*", ExactEvmScheme(signer=EthAccountSigner(
        Account.from_key("0x<key holding USDC on Base>"))))
    async with httpx.AsyncClient(transport=x402_httpx_transport(xc),
                                 base_url="https://transcriptd.fly.dev") as c:
        r = await c.get("/transcript", params={"video": "dQw4w9WgXcQ", "format": "text"})
        print(r.text)

asyncio.run(main())

Servidor MCP

Wrapper ligero en mcp/server.py — herramientas get_transcript y get_video_metadata. Tu clave de wallet permanece en TU configuración de cliente; nunca sale de tu máquina.

{
  "mcpServers": {
    "transcriptd": {
      "command": "python",
      "args": ["mcp/server.py"],
      "env": { "X402_PRIVATE_KEY": "0x<key holding USDC on Base>" }
    }
  }
}

Actor de Apify

Mismo motor, facturación de Apify, proxy residencial incluido: apify.com/outspoken_sitkaspruce/transcriptd — ingresa una lista de URLs de videos, obtén un dataset de transcripciones, se cobra solo por transcripción entregada.

Notas

  • Solo subtítulos (manuales preferidos, autogenerados como respaldo) — sin ASR.
  • El extractor se actualiza automáticamente a diario; los límites de tasa de timedtext se reintentan con backoff.
  • Salida JSON: {video_id, language, source, segments: [{start, dur, text}], text}.