> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 音声からテキストへ

sunra API を使用して音声をテキストに変換するには、適切なエンドポイントに必要な入力パラメータを指定してリクエストを送信する必要があります。API は、事前にトレーニングされたモデルを活用して音声ファイルをテキストに書き起こし、音声ファイルを提供するだけでシームレスな変換を可能にします。

sunra API を使用して音声からテキストへの変換を行う方法は次のとおりです。

<CodeGroup>
  ```javascript Javascript theme={null}
  import { sunra } from "@sunra/client";

  const result = await sunra.subscribe("elevenlabs/scribe-v1/speech-to-text", {
    input: {
      audio: 'https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav',
      language: 'English',
      tag_audio_events: true,
      speaker_diarization: false
    },
    logs: true,
    onQueueUpdate: (update) => {
      console.log(update)
    },
  });
  console.log(result.data);
  console.log(result.requestId);
  ```

  ```python Python theme={null}
  import sunra_client

  result = sunra_client.subscribe(
      "elevenlabs/scribe-v1/speech-to-text",
      arguments={
          "audio": "https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav",
          "language": "English",
          "tag_audio_events": True,
          "speaker_diarization": False
      },
      with_logs=True,
      on_enqueue=print,
      on_queue_update=print,
  )
  print(result) 
  ```

  ```java Java theme={null}
  import ai.sunra.client.*;
  import java.util.Map;
  import com.google.gson.JsonObject;

  var client = SunraClient.withEnvCredentials();

  var response = client.subscribe(
      "elevenlabs/scribe-v1/speech-to-text",
      SubscribeOptions.<JsonObject>builder()
          .input(Map.of(
              "audio", "https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav",
              "language", "English",
              "tag_audio_events", true,
              "speaker_diarization", false))
          .resultType(JsonObject.class)
          .onQueueUpdate(update -> System.out.printf(
              "\nステータス更新: %s, リクエストID: %s%n",
              update.getStatus(),
              update.getRequestId()
          ))
          .logs(true)
          .build()
  );

  System.out.println("完了しました！");
  System.out.println(response.getData());
  ```

  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.sunra.ai/v1/queue/elevenlabs/scribe-v1/speech-to-text \
    --header "Authorization: Key $SUNRA_KEY" \
    --header "Content-Type: application/json" \
    --data '{"audio":"https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav","language":"English","tag_audio_events":true,"speaker_diarization":false}'

  ```
</CodeGroup>

### 適切なモデルの選択

sunra は、さまざまなニーズに合わせてさまざまな音声からテキストへのモデルを提供しています。精度とパフォーマンスの要件に基づいてモデルを選択してください。

利用可能なオプションの一部を次に示します。

* **[elevenlabs/scribe-v1](https://sunra.ai/models/elevenlabs/scribe-v1)**: 99 言語の音声からテキストへの変換、単語レベルのタイムスタンプとダイアライゼーションを備えています。これは同社で最も正確な ASR です。

特定のモデルを使用するには, 例に示すように `subscribe` メソッドでその ID を指定します。その他のモデルと詳細については, [音声からテキストへのモデル](https://sunra.ai/models?modalities%5B0%5D=modality-audio-text) ページをご覧ください。