クイックスタート

最小限のリクエストで最初のAPI呼び出しを完了します。用意するのはAPIキーと利用可能なvoice_idだけです。

APIキーの取得

APIキー管理プラットフォームにアクセスして、APIキーを作成します。完全なキーは一度しか表示されません。サーバー側の環境変数またはシークレット管理システムに保存し、ブラウザのコードや公開リポジトリには書き込まないでください。

環境変数の設定

ローカルでデバッグする際は、APIキーを環境変数に設定します。

export MOSS_API_KEY="<your_api_key>"

$env:MOSS_API_KEY="<your_api_key>"

最初のリクエストの送信

以下の呼び出しでは、単一話者の音声生成APIを使用します。voice_idはボイス一覧の取得またはボイスの作成APIで取得できます。

curl -X POST "https://api.mosi.cn/v1/audio/speech" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moss-tts-1.5-flash",
    "input": "Moss APIへようこそ。[pause 0.8s]これから音声を生成します。",
    "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
    "response_format": "mp3",
    "delivery_method": "url"
  }'

返却結果の読み取り

このリクエストではdelivery_method=urlを使用しているため、成功後にレスポンスのurlを読み取って生成された音声を取得します。非同期呼び出しに変更する場合は、返されたtask_idを使ってGET /v1/audio/tasks/{task_id}を呼び出し、最終状態と結果を照会します。

次のステップ