/v1, pra tudo que a plataforma
faz: monitorar fontes (canais e vídeos do YouTube, RSS, X), transcrever e
analisar com agentes, organizar em coleções e buscar na biblioteca inteira.
O modelo
Items
Uma fonte monitorada — canal do YouTube, um vídeo, um feed RSS. A unidade
atômica; todo o resto aponta de volta pros items.
Coleções
Agrupam items. Privadas ou públicas; podem ser pagas (fãs assinam).
Reporters
Agentes que processam fontes. Um reporter roda workflows (sequência de
steps, cada um uma tool + prompt) e pode rodar em schedule.
Executions
Toda execução (transcript, workflow, schedule) cria uma execution que você
acompanha até concluir.
Transcripts & documents
Artefatos produzidos a partir dos items: transcripts (um por idioma) e
documents (resumos e outras saídas de workflow).
Search & discover
Busca semântica na sua biblioteca, e um catálogo público (
discover) de
coleções, reporters e usuários.Base URL
A API inteira vive sob/v1:
Dois crachás, uma API
Os mesmos endpoints aceitam qualquer um dos crachás — só muda a cobrança:- API key (
ck_live_…) — pra integradores. Cobrada por chamada do saldo da key (taxa flat de plataforma + pass-through). É o que estes guias usam. - JWT de sessão — o que o app web usa (de
POST /v1/auth/login). Sem taxa de plataforma, só pass-through.
Próximo
Faça a primeira chamada no quickstart, depois leia
Conceitos — em especial operações assíncronas,
de que a maioria das escritas depende.