> ## 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.

# Transcrever um vídeo

> Gere um transcript de forma assíncrona e leia de volta.

Transcrição é **assíncrona** — chama um transcriber externo. O request retorna
`202` com uma [execution](/pt/async-operations); você acompanha até concluir e
então lê o transcript.

## 1. Dispare o transcript

```bash theme={null}
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 }'
```

```json theme={null}
{ "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](/pt/async-operations)
pra um helper de polling pronto):

```bash theme={null}
curl https://api.clipping.cc/v1/executions/exc_… \
  -H "Authorization: Bearer ck_live_…"
```

## 3. Leia o transcript

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

```json theme={null}
{
  "transcript": {
    "item_id": "itm_video_123",
    "lang": "pt",
    "text": "…",
    "segments": [{ "start": 0.0, "end": 4.2, "text": "…" }]
  }
}
```

<Tip>
  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](/pt/guides/search).
</Tip>

## 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.