API キーと利用状況

コンソール（https://token.echohub.io/console ）は、API キーと利用状況を管理する画面です。Echo AI Hub のアカウントでログインします。

登録の直後は、「API の利用を準備しています」と表示されます。準備ができると、画面は自動で切り替わります。時間がかかる場合は、数分後にページを開き直してください。

API キーを発行する

1. メニューの「APIキー」を開き、「キーを発行」を押します
2. 「名前」に、用途が分かる名前を入れます（例：本番サーバー）。全角 16 文字、半角 50 文字まで入れられます。同じ名前のキーは作れません
3. このキーで使える金額を制限する場合は、「利用上限（円）」に金額を入れます。空欄の場合は、アカウントの残高の範囲で使えます
4. 「発行する」を押すと、キーが表示されます。「キーをコピー」を押して、安全な場所に保管します

• キーは sk- で始まる文字列です
• 発行したあとも、一覧のメニューの「キーを表示」で、もう一度表示できます（1 時間に 10 回まで）
• 1 つのアカウントで発行できるキーは 1,000 本までです（暫定）。発行は 1 時間に 20 本までです

用途ごと（本番のサーバー、手元の開発、ツールごとなど）にキーを分けておくと、問題があったときにそのキーだけを止められます。

注意：キーは他の人に見せないでください。公開するリポジトリや、ブラウザで動くコードにも書かないでください。

キーの一覧

「APIキー」の一覧で、キーごとに次の項目を確認できます。

キーの操作

一覧の各行の右端にあるメニューから、次の操作ができます。

停止中のキーや削除したキーで呼び出すと、HTTP 401 が返ります。削除しても、これまでの利用記録は呼び出し履歴に残ります。

キーが漏れたときは、すぐにそのキーを停止するか削除し、新しいキーを発行してください。

利用上限

発行時や「利用上限を変更」で入れた「利用上限」は、そのキーで使える金額の上限です。使った分だけ減り、自動で元に戻ることはありません。

上限に達したキーは、状態が「上限に達した」になり、その行に「利用上限を変更」のボタンが表示されます。上限を増やすと、キーは自動で再開します。プログラムのキーを差し替える必要はありません。

上限に近づいたとき、上限に達したときに返るエラーは上限とレート制限にあります。

利用状況を見る

メニューの「利用状況」で、期間を選んで次の項目を確認できます。時刻は日本時間です。

合計・日別・モデル別は 1 時間ごとに集計します。最新の呼び出しが反映されるまで、最大 5 分かかります。

呼び出し履歴を見る

メニューの「呼び出し履歴」に、呼び出し 1 回ごとの記録が新しい順に表示されます。リクエストとモデルの回答の本文は表示しません。記録している項目はデータの取り扱いにあります。

記録に反映されるまで、数秒かかることがあります。

動画生成のタスク

動画生成のタスク（動画生成）は、1 つのタスクを 1 行で表示します。

残高とチャージ

メニューの「残高とチャージ」で、現在の残高、そのうちの特典分、いちばん近い有効期限を確認できます。

内訳とチャージ履歴は、会員サイト Echo AI Hub の公開後に表示されます。

チャージの手順は次のとおりです。

1. 「残高とチャージ」の「チャージする」を押します。残高が少ないときや 0 円のときは、各ページの上の一行にある「チャージする」からも開けます
2. 金額を選んで「お支払いへ進む」を押します。この画面に、金額ごとのチャージ後の残高、支払う前に確認する事項（残高に加わる額、反映の時期、有効期限、返金）と、「利用規約」「特定商取引法に基づく表記」へのリンクがあります
3. Stripe のお支払い画面に移動します。クレジットカードで支払います。領収書は Stripe からメールで届きます
4. 支払いが終わると、「チャージする」を押したページに戻ります。残高への反映には、数秒から 1 分ほどかかることがあります。反映されると、画面は自動で更新されます

チャージできる金額、有効期限、請求書と領収書は料金とチャージにあります。

確認した情報源