VocalStack Logo

Documentation

転写データを取得

待ち受け中の転写や完了した転写からデータを取得します。 これには転写タイムライン，キーワード，要約，段落セグメントが含まれる。

マイクやライブストリームから転写

マイクやライブストリームからのライブスピーチを転写します。 Polyglot と統合して、ユーザがどの言語でも読める転写の公開共有リンクを作成します。

転写セッション

転写状態をセッションでモニタし管理する。 これは、セッションを使って、以前に作成した非同期接続に再接続することができます。

転写を翻訳

転写されたテキストを他の言語に翻訳します。 これは，予め録音された転写，ライブ転写，またはポリグロットセッション転写を含むすべての転写に対して行うことができる。

URL からオーディオを転写

クライアント側認証トークン

クライアント側の要求に対して一時的な認証トークンを作成します。 API キーを公開せずにウェブブラウザで API 要求を安全に実装します。

転写要求と応答

すべての転写操作に対する共通の要求オプションと応答。転写設定を設定するにはオプションを使用してください。

ポリグロットセッションを転写してプレゼンテーション

ライブ転写を公開共有リンクを通して放送するためのセッションを作成します。 ユーザは、自分の好きな言語でライブ転写を読み、セッションが非アクティブの時に過去の転写を読むことができる。

URL からオーディオを転写

ドキュメントを閲覧
URL に記録された音声をプレーンテキストに転写する。 主要なファイルフォーマットは，ＭＰ３，ＷＡＶ，ＦＬＡＣ，ＯＧＧを含む。.

クイックスタート

URL にある音声ファイル (例えば mp3) を数行のコードでテキストに変換します:
JavaScript
import { UrlTranscription } from '@vocalstack/js-sdk';

const sdk = new UrlTranscription({ apiKey: 'YOUR-API-KEY' });
const transcription = await sdk.connect({
  url: 'http://example.com/files/meaningless.mp3',
});

transcription.start();

// This will print the transcription data as it comes in
transcription.onData(console.log);

/*
{
  status: 'processing',
  data: {
    id: 'd1e7b3b0-7b3b-4b3b-8b3b-0b3b7b3b3b3b',
    operation: 'transcription-prerecorded',
    progress: 0.1,
    timeline: [
      {
        start: 0,
        end: 7.52,
        text: 'Meaningless, meaningless, says the teacher, utterly meaningless, everything is meaningless.',
        language: 'en',
        translations: { ... },
      },
      ...
    ]
  }
}
*/

リクエストオプションと応答データ

複数の要求オプションが利用可能で、転写設定をカスタマイズできます。 また，応答オブジェクトは転写過程の各段階で異なるデータを提供する。.
転写要求と応答
すべての転写操作に対する共通の要求オプションと応答。転写設定を設定するにはオプションを使用してください。.
次に、カスタムオプションを使って転写プロセスを設定する方法を見てみましょう。:
JavaScript
// Run "npm install @voca l-stack/js-sdk" to install the package
import { UrlTranscription } from '@vocalstack/js-sdk';

// Get your key here ⇢ https://www.vocalstack.com/dashboard/api-keys
const sdk = new UrlTranscription({ apiKey: 'YOUR-API-KEY' });

const transcription = await sdk.connect({
  // URL to the audio file
  url: 'http://example.com/files/audio.mp3',
  // Optional: language of the speech spoken
  // (this can be used to improve the transcription accuracy)
  language: 'en',
  // Optional: the maximum duration to transcribe, in seconds
  // (if not provided, the entire audio file will be transcribed)
  max_duration_s: 1800,
  // Optional: the actual duration of the audio file, in seconds
  // (the transcription starts only if the audio file matches this duration)
  duration_s: 3600,
});

// Start the transcription
transcription.start();

// Listen for transcription data
transcription.onData((response) => {
  const { status, data } = response;
  console.log(status); // 'waiting', 'processing', 'done', or 'error'
  if (data) {
    console.log(data.progress); // a value between 0 and 1
    console.log(data.timeline); // an object with the transcription timeline
  }
  if (status === 'done') {
    console.log(data.summary); // a summary of the transcription
    console.log(data.keywords); // an array of keywords
    console.log(data.paragraphs); // the entire transcription in paragraph form
  }
});

次のステップ

音声ファイルにスピーチを転写したら、次のいずれかに移動したいかもしれません。:
転写データを取得
待ち受け中の転写や完了した転写からデータを取得します。 これには転写タイムライン，キーワード，要約，段落セグメントが含まれる。.
転写を翻訳
転写されたテキストを他の言語に翻訳します。 これは，予め録音された転写，ライブ転写，またはポリグロットセッション転写を含むすべての転写に対して行うことができる。.
転写セッション
転写状態をセッションでモニタし管理する。 これは、セッションを使って、以前に作成した非同期接続に再接続することができます。.
Scroll Up