見出し画像

AivisHubの限定公開モデルをAivis Cloud APIで使う方法｜アクセスキーの指定と管理を解説！

Aivis Project

この記事はこんな方に向けた内容です。
・取引先や社内メンバーにだけ音声合成モデルを共有したい方
・限定公開モデルをAivis Cloud APIから利用したい方
・APIキーとアクセスキーの違いがわからない方
・一般公開する前に関係者へモデルを試してもらいたい方

⚠️ 本記事の内容は、2026年8月時点の情報です。AivisHubおよびAivis Cloud APIの仕様は今後更新される可能性があるため、利用時は最新の公式サイトやAPIドキュメントもあわせてご確認ください。

皆さんこんにちは。
感情豊かな音声合成技術を誰もがかんたんに活用できる未来を目指す、Aivis Projectです✨

「制作したモデルを、取引先にだけ試してもらいたい」
「一般公開する前に、社内や関係者の間で確認したい」

音声合成モデルを共有するとき、誰でも利用できる一般公開と、自分だけが利用できる非公開の二択では困る場面があります。

その中間を埋めるのが、AivisHubの限定公開です。

限定公開モデルは、共有URLを知っている方にAivisHub上で共有できるほか、ak_から始まるアクセスキーを使って、Aivis Cloud APIから音声を生成できます。

この記事では、限定公開モデルをAivis Cloud APIから利用する方法と、APIキーとの違い、共有を停止するときのアクセスキー管理までを順番に解説します📚


【結論】アクセスキーをmodel_uuidに指定する

限定公開モデルを投稿者以外がAivis Cloud APIから利用する場合は、モデルUUIDの代わりに、ak_から始まるアクセスキーをmodel_uuidへ指定します。

{
  "model_uuid": "ak_xxxxxxxxxxxxxxxxxxxx",
  "text": "限定公開モデルで音声を生成します。",
  "output_format": "mp3"
}

access_keyのような別のフィールドを追加するわけではありません。

フィールド名はmodel_uuidのまま、その値をモデルUUIDからアクセスキーへ置き換えるのがポイントです。

なお、Aivis Cloud APIを呼び出すには、これとは別にCloud API用のAPIキーが必要です。

Cloud API用APIキー
Authorization: Bearerヘッダーに指定し、APIの利用者を認証する

限定公開モデルのアクセスキー
model_uuidに指定し、利用する限定公開モデルを特定する

⚠️ アクセスキーだけではCloud APIを利用できません。
呼び出す側は、自分のCloud API用APIキーも用意してください。

【前提】AivisHubの限定公開とは

限定公開は、発行された共有URL・アクセスキーを知っている方がモデルへアクセスできる公開設定です。

限定公開モデルには、次の特徴があります。

・AivisHubの一般的な検索結果には表示されない
・外部の検索エンジンにも原則として表示されない
・一般公開時の審査を待たずに利用できる
・共有URLを通じて関係者へ共有できる
・アクセスキーを使ってAivis Cloud APIから利用できる

AivisHubの限定公開機能は、取引先への限定共有や、一般公開前の試用、社内メンバーによる確認などに適しています✨

ただし、限定公開は、共有相手のアカウントを一人ずつ指定して許可する仕組みではありません。

共有URLやアクセスキーを受け取った方が、さらに第三者へ転送すると、その第三者からもアクセスされる可能性があります。

「特定の相手にだけ共有する」という目的で利用する場合は、共有URLとアクセスキーの管理も含めて運用する必要があります。

【手順1】モデルを限定公開に設定する

AivisHubのモデル詳細ページ

まず、AivisHubへアップロードしたモデルの編集ページを開き、公開状態を「限定公開」へ変更します。

限定公開には一般公開時の審査がないため、審査結果を待つ必要はありません。

すでに非公開でアップロードしているモデルも、公開状態を限定公開へ変更することで共有できます。

⚠️ モデルをアップロードしてからAivis Cloud APIの音声合成環境へ反映されるまで、最大5分程度かかる場合があります。
設定直後に呼び出せない場合は、少し時間を置いてから再度お試しください。

【手順2】共有URLとアクセスキーを確認する

AivisHubのモデル詳細ページ

限定公開へ変更すると、モデルの詳細ページまたは編集ページから、次の情報を確認できます。

  • 共有URL：AivisHub上のモデルページを相手へ共有するときに使う

  • アクセスキー：Aivis Cloud APIから限定公開モデルを呼び出すときに使う

Aivis Cloud APIで使うのは、ak_から始まるアクセスキーです。

共有URLやアクセスキーは、公開リポジトリ、SNS、誰でも閲覧できる資料などへ掲載しないでください。

スクリーンショットを共有するときも、アクセスキーの全体が映らないようにマスキングしてください。

【手順3】Aivis Cloud APIのAPIキーを用意する

限定公開モデルを利用する側は、Aivis Cloud APIダッシュボードから自分のAivis Cloud APIのAPIキーを発行します。

APIキーは、リクエストのAuthorizationヘッダーへ指定します。

Authorization: Bearer YOUR_AIVIS_API_KEY

モデルの所有者が、取引先へ自分のAivis Cloud API用APIキーを渡す必要はありません。

【手順4】音声合成APIへアクセスキーを指定する

音声合成には、次のエンドポイントを使用します。

POST https://api.aivis-project.com/v1/tts/synthesize

curlから実行する場合は、次のようになります。

curl -X POST \
  "https://api.aivis-project.com/v1/tts/synthesize" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_uuid": "ak_xxxxxxxxxxxxxxxxxxxx",
    "text": "限定公開モデルで音声を生成します。",
    "output_format": "mp3"
  }' \
  --output limited-model.mp3

  • API_KEYには、呼び出す側のCloud API用APIキーを指定する

  • model_uuidには、限定公開モデルのアクセスキーを指定する

  • textには、音声にしたい文章を指定する

リクエストに成功すると、指定した形式の音声データが返ります。

投稿者本人はモデルUUIDのまま利用できる

限定公開モデルを投稿した本人は、アクセスキーではなく、通常のモデルUUIDを指定して利用できます。

{
  "model_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "text": "モデル投稿者として音声を生成します。"
}

アクセスキーが必要になるのは、限定公開モデルを投稿者以外のアカウントから利用する場合です。

投稿者本人までアクセスキーへ置き換える必要はありません。

【重要】アクセスキーを無効化・再生成する

共有先を変更したい場合や、アクセスキーが第三者へ漏れた可能性がある場合は、モデル編集ページからアクセスキーを再生成できます。

アクセスキーを再生成すると、以前の共有URLとアクセスキーは無効になり、新しいものへ切り替わります。

⚠️ モデルを一度非公開へ変更し、その後もう一度限定公開へ戻しただけでは、以前のアクセスキーは自動的に無効化されません。

古い共有URLを今後使えない状態にしたい場合は、公開状態の変更だけで済ませず、アクセスキーを再生成してください。

アクセスキーを再生成すると、それまでそのキーを使っていたシステムからは利用できなくなります。
共有先へ新しいキーを案内し、システム側の設定も更新しましょう。

【運用】2つのキーを安全に管理する

Aivis Cloud APIのAPIキーと、限定公開モデルのアクセスキーは、どちらも公開しないことが重要です。

Aivis Cloud APIのAPIキー

  • ソースコードへ直接記載しない

  • GitHubなどの公開リポジトリへコミットしない

  • 環境変数やシークレット管理機能へ保存する

  • 第三者へ共有しない

限定公開モデルのアクセスキー

  • 公開資料やSNSへ掲載しない

  • 共有先を必要最小限にする

  • 漏えいの可能性がある場合は再生成する

  • ログへ不用意に記録しない

APIキーは「誰がCloud APIを利用するか」を認証するものです。

アクセスキーは「どの限定公開モデルを利用できるか」を示すものです。

役割は異なりますが、どちらも外部へ公開しない情報として扱ってください。

【補足】ユーザー辞書も一緒に使う場合

限定公開モデルにも、音声合成時にユーザー辞書を適用できます。

{
  "model_uuid": "ak_xxxxxxxxxxxxxxxxxxxx",
  "user_dictionary_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "text": "自社サービス名を正しい読み方で音声合成します。"
}

ただし、ユーザー辞書はAivis Cloud APIのAPIキーの所有者ごとに管理されます。

取引先が自分のAPIキーで音声合成する場合、取引先側のアカウントでユーザー辞書を作成またはインポートする必要があります。

限定公開モデルのアクセスキーを共有しただけで、モデル所有者のユーザー辞書まで共有されるわけではありません。

【権利】限定公開でも許諾とライセンスは必要

限定公開には一般公開時の審査がありませんが、これは権利の確認が不要という意味ではありません。

他人の声、キャラクター、学習素材などを使用している場合は、公開範囲にかかわらず、アップロードや共有に必要な権利・許諾を確認してください。

また、モデルを利用する側も、そのモデルに設定されたライセンスや利用条件を守る必要があります。

アクセスキーを持っていることは、ライセンスで許可されていない使い方まで認めるものではありません。

よくある質問（FAQ）

Q. 限定公開モデルのアクセスキーはどこで確認できますか？

限定公開モデルの詳細ページまたは編集ページから確認できます。
Aivis Cloud APIへ指定するのは、ak_から始まる文字列です。

Q. アクセスキーだけでCloud APIを利用できますか？

利用できません。
Aivis Cloud APIのAPIキーも必要です。

APIキーはAuthorization: Bearerヘッダー、アクセスキーはリクエストボディのmodel_uuidへ指定します。

Q. 投稿者本人もアクセスキーを使う必要がありますか？

必要ありません。
投稿者本人は、通常のモデルUUIDを指定して利用できます。

Q. 以前のアクセスキーを使えないようにできますか？

モデル編集ページからアクセスキーを再生成してください。
再生成すると、以前の共有URLとアクセスキーが無効になります。

非公開へ変更してから限定公開へ戻すだけでは、以前のアクセスキーは自動的に無効化されません。

Q. 404エラーが返ってきます。

次の点を確認してください。

・投稿者以外がモデルUUIDを指定していないか
・最新のアクセスキーを指定しているか
・アクセスキーを再生成したあと、古いキーを使っていないか
・モデルが限定公開の状態になっているか
・モデルのアップロードや設定変更から5分程度経過しているか

また、URLがPOST /v1/tts/synthesizeになっているかも確認してください。

Q. 取引先ごとにユーザー辞書も共有できますか？

限定公開モデルのアクセスキーと、ユーザー辞書は別々に管理されます。

取引先側のアカウントで新たにユーザー辞書を作成するか、AivisSpeech互換の辞書データをインポート・エクスポートしてください。

Q. 限定公開なら、許諾を得ていない声のモデルも共有できますか？

できません。
限定公開や非公開であっても、第三者の権利を侵害するモデルはアップロードできません。

声、キャラクター、学習素材などに第三者の権利が関係する場合は、必要な許諾と利用条件を事前に確認してください。

まとめ

・限定公開モデルは、一般検索には原則表示されず、共有URLを知っている方へ共有できる
・投稿者以外がCloud APIから利用する場合は、model_uuidにak_から始まるアクセスキーを指定する
・アクセスキーとは別に、呼び出す側のAivis Cloud APIのAPIキーが必要
・モデルの投稿者本人は、通常のモデルUUIDで利用できる
・共有を停止するときは、アクセスキーを再生成して以前の共有URLを無効化する
・非公開へ変更してから限定公開へ戻すだけでは、以前のアクセスキーは無効化されない
・限定公開でも、モデルに関係する権利やライセンス条件の確認は必要

限定公開は、一般公開と非公開の間を埋めるだけでなく、取引先への試用、社内確認、一般公開前のテストをスムーズに進めるための仕組みです。

APIキーとアクセスキーの役割を正しく分け、安全に管理しながら活用してみてください✨

以上で、この記事はおしまいです。

Aivis ProjectやAivisHub、Aivis Cloud APIに関してご不明点やご相談がある場合には、お問い合わせフォームよりお気軽にご連絡ください。


いいなと思ったら応援しよう！