feat: transcribe command

docs/cli/transcribe.md

@@ -0,0 +1,43 @@
+## Synopsis
+
+```
+osc transcribe [options] <source>
+```
+
+## Description
+
+Transcribe an audio or video file using [Subtitle Generator](https://app.osaas.io/dashboard/service/eyevinn-auto-subtitles) in Open Source Cloud.
+
+## Prerequisites
+
+OpenAI API key
+
+## Example
+
+In this example the OpenAI API key is stored in a secret called `openaikey` which is the recommended way to work with sensitive data in the platform.
+
+```bash
+% export OSC_ACCESS_TOKEN=<your-secret-pat>
+% export OPENAI_API_KEY="{{secrets.openaikey}}
+% osc transcribe https://testcontent.eyevinn.technology/mp4/stswe-tvplus-promo.mp4
+WEBVTT
+
+00:00:00.000 --> 00:00:05.360
+Probably the most interesting challenge of the 21st century.
+
+00:00:05.360 --> 00:00:07.200
+Streaming tech TV plus.
+
+00:00:07.200 --> 00:00:08.200
+Money.
+
+00:00:08.200 --> 00:00:10.420
+Money, money, money, money.
+
+00:00:10.420 --> 00:00:13.700
+Great streaming tech talks curated from all over the world.
+
+00:00:13.700 --> 00:00:18.280
+They said they would prefer blur if I was going like this.
+...
+```

mkdocs.yml

@@ -14,6 +14,7 @@ nav:
       - osc: cli/core.md
       - osc transcode: cli/transcode.md
       - osc packager: cli/packager.md
+      - osc transcribe: cli/transcribe.md
       - osc compare: cli/compare.md
       - osc intercom: cli/intercom.md
   - APIs: