Tech Blog
  • HOME
  • Blog
  • AmiVoice APIを安全に使おう!APIキー発行&接続元IPアドレス制限実践ガイド

AmiVoice APIを安全に使おう!APIキー発行&接続元IPアドレス制限実践ガイド

公開日:2026.06.18 最終更新日:2026.06.23

M.K

みなさま、こんにちは。AmiVoice Cloud Platform 営業担当です。 

突然ですが、AmiVoice API を使うときに欠かせない接続情報である「API キー」、
みなさんどのように扱っていますか? 

「とりあえず設定しているけれど、実はセキュリティがちょっと不安…」
「できればもっと安全に使いたい…」
そう思われている方もいらっしゃるのではないでしょうか。

「APIキー」は、AmiVoice APIをご利用いただく際に必要となる認証情報であり、非常に重要な機密情報です。このキーが漏洩すると、第三者によって不正に利用され、予期せぬ料金が発生してしまう可能性があります。 

サービスを提供する立場として、お客様にはAPIキーを厳重に管理していただき、AmiVoiceを安心して、長くご利用いただければと思います。 

本記事では、そんな「APIキー」のさらなる活用について紹介させていただきます。 

目次

APIキーとは?

みなさま、実は2025年6月の マイページリニューアル以降、マイページからAPI キーを発行できるようになっていることはご存じでしょうか? 

これまでは「API キー発行API」を用いて開発いただく形でのみ発行可能でしたが、マイページリニューアル以降、開発不要で、マイページから簡単に発行いただけるようになりました! 

「API キーは大事な情報だから、できるだけ安全に扱いたい」 

「特定のネットワークからだけAmiVoice APIを使わせたい」 

そんな場面で役立つのが、API キー発行機能です。

有効期限のあるキーが作成できたり、特定の場所からのみAmiVoice APIを使わせる=接続元IPアドレス制限をする)ことができたり、不正利用がわかった際にはすぐに無効化できたり…。こんな便利なAPIキーがマイページからGUIで作成できるのです。 

本記事では、そんなAPI キー発行機能について、 

  • 利用するメリット 
  • 発行方法 
  • 削除方法や注意点 

を中心にご紹介いたします。 

なお、本記事でご紹介した内容とあわせて、APIキーについてはマニュアルにも記載しております。より詳細な情報につきましては、下記ページをご覧ください。

API キー | AmiVoice API マニュアル | AmiVoice Cloud Platform 

API キー発行機能を使うメリット 

まずは、API キー発行機能を使うメリットを整理します。 

有効期限を設定できる 

API キー発行時、有効期限を設定できます。 

有効期限は発行日時と有効時間によって決まり、期限を過ぎると自動的に無効化されます。 

これにより、万が一API キーが流出した場合でも、影響範囲を最小限に抑えることができます。 

なお、API キー発行時には、有効期限を「無期限」として設定することも可能です。 

接続元IPアドレス制限ができる 

API キー発行時、接続可能なIPアドレスを指定可能です。 

また、複数の接続元IPアドレス指定にも対応しています。 

接続可能なIPアドレスを指定することで、アクセスを特定の場所、例えば社内ネットワークからのみに限定することが可能です。これにより、不正アクセスを予防した運用が可能です。 

有効期限の設定と同様、万が一APIキーが流出してしまった場合でも、あらかじめ利用可能な接続元IPアドレスを指定しておくことで、その影響範囲を抑えることができます。 

マイページ上で発行する方法 

ここからは、実際にマイページ上からのAPI キー発行方法と、接続元IPアドレス の設定方法をご紹介いたします。 

STEP1:マイページの発行画面を開く 

マイページにログインし、接続情報欄にある [API キーの発行]をクリックします。

※マイページへのログインはこちら

STEP2:発行時の設定を入力 

APIキーの発行画面にて、発行するAPI キーの設定を入力します。設定できる主な項目は次の通りです。 

①有効期限 

  • 特定の年月日を設定 
  • 発行日を元に使用期限を設定 
  • 無期限 

の3種類から指定が可能です。 

なお、API キー発行APIを用いて発行する場合は、有効時間をミリ秒単位で指定できます。 

接続元IPアドレス 

許可したい接続元IPアドレスを入力します。複数指定も可能です。  

こちらを設定いただくことで、IPレベルでのアクセス制御が行われます。 

(参考:Q. BIZTELの音声認識連携で、ACPのAPI キーとして、利用できるIPアドレスを指定したAPI キーを使いたい場合、IPアドレスには何を指定したら良いですか?) 

API キー発行権限の有無

こちらは、API キー発行APIを利用する開発者様向けの機能となっています。 [発行可能]のチェックボックスにチェックを入れると、“API キー発行可能なAPI キー”として発行されます。

APIキー発行APIを利用する際、「APIキー発行可能」に設定して発行したAPIキー、またはマイページで確認できるサービスID&サービスパスワードのどちらかをリクエストパラメータで指定する必要があります。

マイページからのAPI キー発行については、①、②が主な設定項目となります。①、②に必要事項を設定後、[発行]をクリックすると、API キーが発行されます。 

STEP3:発行されたAPI キーを確認 

画像内④の空欄に、発行されたAPI キーが表示されます。コピーをしてご利用ください。 

発行されたAPI キーは、発行10分後から利用可能な状態となります。 

なお、発行されたAPI キーは、発行画面を閉じた後もマイページ内 接続情報欄から確認・コピーが可能ですのでご安心ください。 

APIキー発行APIでの発行について 

こちらは開発者様向けの機能となりますが、APIキーは、マイページからの発行に加えて、「APIキー発行API」を利用した発行にも対応しています。 

マイページからの発行は設定や管理を手軽に行いたい場合に最適ですが、 実際のシステム運用やサービス連携では、 

  • 処理のタイミングに合わせてAPIキーを発行したい 
  • 短時間のみ有効なAPIキーを大量に発行したい 
  • APIキーの発行や失効をシステム側で制御したい 

といった要件が求められることもあるのではないでしょうか。 

こうした実務的なニーズに対応できるのが、APIキー発行APIです。 APIキー発行APIを利用すると、有効期限や接続元IPアドレス制限を付与したAPIキーを、 サーバサイドから動的に発行することができます。 

APIキー発行APIの詳細な利用方法については、以下のマニュアルをご参照ください。 

API キー発行 API を用いる方法 | AmiVoice API マニュアル | AmiVoice Cloud Platform 

API キーの削除方法 

API キーはマイページより削除することもできます。 

削除してから10分経過後に、該当のAPI キーは利用できない状態となります。 

ただし、削除の可否は、発行方法やアカウント作成時期によって異なります。 

✔ マイページで発行したAPI キー(2025/06/30以降) 

→ 削除が可能です。ただし、削除できるAPIキーの数には上限(10件)がございますので、ご利用の際はご注意ください。

手順は以下の通りです。 

①削除したいAPI キーのチェックボックスにチェックを入れる 

[削除]をクリック 

[API キーの削除]画面にて、API キー に間違いがないことを確認の上、[削除]のボタンをクリック 

④アカウントに登録されているメールアドレスへ送られる認証コードを入力し、[送信]ボタンをクリック 

⑤API キーの削除が完了し、アカウントに登録されているメールアドレス宛に、API キー削除を知らせるメールが届きます。 

誤って発行してしまった」「万が一の漏洩や不正利用が疑われる」という場合には、これらのやり方でAPI キーの削除を行ってください。 

なお、APIキーの削除は主に緊急時の無効化(ブラックリスト化)を目的とした機能となっており、削除できる件数には上限があります。日常的な運用や更新用途での削除は想定されていないため、ご注意ください。

また、以下のAPI キーについては、マイページからの削除が行えないためご注意ください。 

✔ 2025/06/30以前に作成したアカウントで発行されたAPI キー 

→ 削除ができません。削除するには退会・再登録が必要です。 

✔ API キー発行APIで発行したAPI キー 

→ マイページからは削除できません。 

API キー利用時の注意点 

API キーは便利な反面、期限付きであることを忘れてしまうと、思わぬタイミングで音声認識が停止してしまう場合があります。 

実際に「突然、音声認識が停止してしまった」とお問い合わせいただいたお客様の利用履歴を確認したところ、原因はAPIキーの有効期限切れであった…という事例もあります。

AmiVoice APIをご利用いただく際には、以下の対策ポイントをご参考のうえ、音声認識利用中にAPI キーの有効期限が切れてしまわないようお気を付けください。 

対策ポイント 

  • 運用期間に応じて、有効期限を短すぎる値にしない 
  • 定期更新のルールを決める 
  • 長期稼働が前提のサービスでは、無期限なAPI キーの利用も選択肢  ※

※無期限のAPIキーは、用途やアクセス元が厳密に管理されているなど、安全性を十分に担保できる場合のご利用を推奨しております。

APIキーの削除機能には上限が設けられているため、「後から削除できるから無期限で発行しても問題ない」といった運用は推奨しておりません。恒常的に使用し続けることが決まっている場合を除き、APIキーには有効期限を設定してください。

大事なAPIキー。お客様自身でしっかり管理をお願いします! 

また、API キーの基本的な取り扱いについては、下記Tech Blogでも解説しています!ぜひご覧ください。 

まとめ:よりセキュアなAPIキー活用にはAPI キー発行機能が最適 

API キー発行機能を利用すれば、マイページから簡単に接続元IPアドレス制限・有効期限設定を実現できるほか、APIキー発行APIの利用による実務的な活用も可能になります。

この機能の主なメリットは、以下の通りです。

  • 有効期限をつけられる 
  • 接続元IPアドレス制限でアクセスを絞り込める 
  • 必要なタイミングで手軽に・何度でも発行できる
  • マイページで発行・削除を完結させることも可能 

クラウド環境でも安心してAmiVoice APIを利用したい方にとって、扱いやすく、かつ安全性を高められる仕組みになっています。

セキュリティのご要件にあわせて、ぜひAPIキー発行機能をご活用ください! 

おわりに

APIキー発行機能は、キーに様々な機能を付加できることに加え、不正が発生した際には迅速に削除することができる、とても有用な機能です。高い安全性を確保しながら、自由な発想で音声認識の利用ユースケースを検討・実装いただくことが可能となります。

本記事が、APIキー発行機能を活用した新たな運用形態や、ビジネスの発展を検討するきっかけとなれば幸いです。

今後も、AmiVoice Cloud Platformをもっと便利に、もっと安心してご利用いただけるよう、マイページ機能の紹介や活用のコツを発信していきます。 

ぜひ、今後のTech Blogもチェックしてください!

この記事を書いた人

  • M.K

    音声認識技術を用いて日常のさまざまな場面が便利になったら良いなと思い、新卒でアドバンスト・メディアに営業として入社。
    大学時代は心理学を専攻していました。趣味は舞台観劇で、好きな食べ物は抹茶スイーツです。

     

APIを無料で利用開始