Cliente Node.js

O cliente Node.js encapsula as APIs públicas de upload e tarefas com helpers tipados.

Instalação

pnpm add video-to-text-js

Inicialização

import { VideoToTextClient } from 'video-to-text-js'

const client = new VideoToTextClient({
  apiKey: process.env.VTT_API_KEY!,
})

Transcrever um arquivo

import { readFile } from 'node:fs/promises'

const file = await readFile('meeting.mp4')

const task = await client.transcriptions.transcribeFile(file, {
  filename: 'meeting.mp4',
  mimetype: 'video/mp4',
  language: 'Auto',
  timestampMode: 'CHUNK',
  transcriptionMode: 'balanced',
  timeoutMs: 10 * 60 * 1000,
})

console.log(task.fullText)

Use precision quando a precisão for mais importante que o custo em créditos.

Upload e criação manual

const upload = await client.uploads.create({
  filename: 'meeting.mp4',
  mimetype: 'video/mp4',
})

await client.uploads.put(upload.uploadUrl, file, {
  mimetype: 'video/mp4',
})

const asset = await client.uploads.complete(upload.uploadId, {
  fileKey: upload.fileKey,
  fileUrl: upload.fileUrl,
  filename: 'meeting.mp4',
  mimetype: 'video/mp4',
  fileSize: file.byteLength,
})

const created = await client.tasks.create({
  assetId: asset.assetId,
  language: 'Auto',
  timestampMode: 'CHUNK',
  transcriptionMode: 'balanced',
})

const result = await client.tasks.wait(created.transcriptId)
console.log(result.fullText)

Resultados da tarefa

tasks.wait() retorna quando a tarefa chega a SUCCEEDED. Se a tarefa chegar a FAILED ou CANCELED, o cliente lança APIError e usa showError como detalhe quando disponível.

Os detalhes da tarefa incluem fullText, chunks, words, sourceDurationMs, resultLanguage, transcriptionMode e billedCredits.

Erros

import { APIError, RateLimitError, UploadError } from 'video-to-text-js'

try {
  await client.transcriptions.transcribeFile(file, {
    filename: 'meeting.mp4',
    mimetype: 'video/mp4',
  })
} catch (error) {
  if (error instanceof RateLimitError) {
    console.error('Please retry later.')
  } else if (error instanceof UploadError) {
    console.error('The media upload did not complete.')
  } else if (error instanceof APIError) {
    console.error(error.errorCode, error.detail)
  }
}

Recursos

Para código-fonte, issues e contribuições, acesse o repositório GitHub video-to-text-js. Instale a versão mais recente do pacote video-to-text-js pelo npm.