Capsiynau REST API

Pass your key in the Authorization header:

Authorization: Bearer ck_live_YOUR_KEY

# Or via X-API-Key header
X-API-Key: ck_live_YOUR_KEY

Rate limit: 60 req/min. Returns 429 when exceeded. Headers: X-RateLimit-Remaining, X-RateLimit-Reset.

Skip raw HTTP - use the official Node SDK:

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, fileUrl, language: 'cy' })
await client.waitFor(job.jobId)
const transcript = await client.getTranscript(job.projectId)
console.log(transcript.segments[0].text)

The SDK parses errors into typed classes (AuthError, PlanGateError, QuotaError, and more) and tracks job status correctly.