@capsiynau/sdk-transcribe@1.0.0
Build with Capsiynau
A REST API and Node SDK for transcribing, subtitling, and exporting Welsh and English content. The same engine we run ourselves.
Quickstart (5 min)
- Sign up for a Pro plan or above to get an API key
- Install the official Node SDK
- Submit a job, poll until done, fetch the transcript
npm install @capsiynau/sdk-transcribe
import { TranscriptionClient } from '@capsiynau/sdk-transcribe'
const client = new TranscriptionClient({ apiKey: process.env.CAPSIYNAU_API_KEY })
const job = await client.submit({
projectId: '00000000-0000-0000-0000-000000000000',
fileUrl: 'https://example.com/audio.mp4',
language: 'cy',
})
await client.waitFor(job.jobId)
const transcript = await client.getTranscript(job.projectId)Demo data - no key required
Try a live transcription
Watch a Welsh transcription job run end-to-end - submit, queue, process, export.
projectId: demo-0000-0000-0000-0000-000000000000fileUrl: https://example.com/audio.mp4duration: 7.8slanguage: cy
- 1Submit
- 2Queue
- 3Process
- 4Export
Click 'Run demo' to see the transcript appear here.
What runs behind the scenes
const job = await client.submit({
projectId: 'demo-0000-0000-0000-0000-000000000000',
fileUrl: 'https://example.com/audio.mp4',
language: 'cy',
})
await client.waitFor(job.jobId)
const transcript = await client.getTranscript(job.projectId)Documentation and references
REST API reference
Every /api/v1/* endpoint with parameters, responses, and auth.
Feature catalog
What you can build: transcription, subtitling, metadata, and Golden Moments.
Code samples
Node SDK, plus Python and curl samples for non-Node integrators.
Error codes
Typed error classes: AuthError, PlanGateError, QuotaError, and more.
Companion products
Llais - Welsh text-to-speech for any site
NewDrop-in Welsh text-to-speech widget. One <script> tag, 3.9 KB gzipped, Bangor LTU voices, shadow-DOM isolated, origin-locked keys.
<script src="https://llais.capsiynau.com/widget.v1.js"
data-key="pk_live_..."
data-voice="nia" defer></script>Visit llais.capsiynau.comAPI access: Pro plan or above
API keys are available on Pro, Studio, and Production Company plans. Some endpoints (Moments, Metadata) require Studio or above.
See plans