Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt

Use this file to discover all available pages before exploring further.

Transcrição é assíncrona — chama um transcriber externo. O request retorna 202 com uma execution; você acompanha até concluir e então lê o transcript.

​
1. Dispare o transcript

curl -X POST https://api.clipping.cc/v1/items/itm_video_123/transcript \
  -H "Authorization: Bearer ck_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "lang": "pt", "embed": true }'

{ "execution": { "execution_id": "exc_…", "status": "pending" } }
CampoSignificado
langIdioma alvo (ex.: pt). Omita pra autodetectar.
embedtrue → gera embeddings pro transcript ficar pesquisável (consome tokens de IA).
textForneça você mesmo um transcript — pula o transcriber externo (sem custo de provedor).

​
2. Aguarde concluir

Faça polling da execution até done (veja Operações assíncronas pra um helper de polling pronto): 
curl https://api.clipping.cc/v1/executions/exc_… \
  -H "Authorization: Bearer ck_live_…"

​
3. Leia o transcript

curl "https://api.clipping.cc/v1/items/itm_video_123/transcript?lang=pt" \
  -H "Authorization: Bearer ck_live_…"

{
  "transcript": {
    "item_id": "itm_video_123",
    "lang": "pt",
    "text": "…",
    "segments": [{ "start": 0.0, "end": 4.2, "text": "…" }]
  }
}
Só conteúdo com embedding é pesquisável. Passe embed: true ao transcrever (ou rode um workflow que produza documents) pra ele aparecer na busca semântica.

​
Custo

Rodar o transcript debita uma taxa flat de 0,01 coin mais o custo real do transcriber (pass-through). Ler de volta é 0,005 coin. Um transcript manual (text fornecido) pula o custo do provedor.