Transcrever um vídeo

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" } }

Campo	Significado
`lang`	Idioma alvo (ex.: `pt`). Omita pra autodetectar.
`embed`	`true` → gera embeddings pro transcript ficar pesquisável (consome tokens de IA).
`text`	Forneç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.

Começando

Conceitos

Guias

Transcrever um vídeo

1. Dispare o transcript

2. Aguarde concluir

3. Leia o transcript

Custo

​1. Dispare o transcript

​2. Aguarde concluir

​3. Leia o transcript

​Custo

1. Dispare o transcript

2. Aguarde concluir

3. Leia o transcript

Custo