文档API 密钥与使用情况

API 密钥与使用情况

汇总在控制台发行、显示、停用和删除 API 密钥,使用上限,使用情况和调用记录的看法,以及余额与充值。

控制台(https://token.echohub.io/console )是管理 API 密钥和使用情况的页面。用 Echo AI Hub 的账号登录。

控制台只有日文。本页里控制台上的名称用日文写,括号里是中文说明。

菜单能做的事
「はじめに」(入门)按顺序确认余额、API 密钥和第一次调用这三项。第一次调用成功之前会显示
「利用状況」(使用情况)查看每个时间段的使用金额、请求数、token 数,以及按天、按模型、按密钥的使用情况
「呼び出し履歴」(调用记录)查看每一次调用的记录。可以筛选,也可以导出 CSV
「APIキー」(API 密钥)发行、显示密钥,修改名称和使用上限,停用和恢复,删除
「残高とチャージ」(余额与充值)查看余额、明细和充值记录,进行充值
「モデルと料金」(模型与价格)打开模型一览
「ドキュメント」(文档)打开本文档

刚注册完时,会显示「API の利用を準備しています」(正在准备 API 的使用)。准备好后,页面会自动切换。时间较长时,请过几分钟重新打开页面。

发行 API 密钥

  1. 打开菜单里的「APIキー」,点「キーを発行」(发行密钥)
  2. 在「名前」(名称)里填一个能看出用途的名称(例:生产服务器)。最多全角 16 个字、半角 50 个字。不能和已有的密钥同名
  3. 要限制这把密钥能用的金额时,在「利用上限(円)」(使用上限(日元))里填金额。不填时,可以在账号余额的范围内使用
  4. 点「発行する」(发行),会显示密钥。点「キーをコピー」(复制密钥),保存到安全的地方
  • 密钥是以 sk- 开头的字符串
  • 发行后,也可以在列表中这把密钥的菜单里点「キーを表示」(显示密钥)再次查看(每小时最多 10 次)
  • 一个账号最多能发行 1,000 把密钥(暂定)。每小时最多发行 20 把

按用途(生产服务器、本地开发、每个工具等)分开使用密钥,出问题时就只需停掉那一把。

注意:不要把密钥给别人看。也不要写进公开的代码仓库或在浏览器里运行的代码。

密钥列表

「APIキー」的列表里,每把密钥可以看到下面这些项目。

项目内容
「名前」(名称)密钥的名称。下面显示密钥开头和结尾的 4 个字符
「状態」(状态)「有効」(有效)、「停止中」(已停用)、「有効期限切れ」(已过期)、「上限に達した」(已达上限)
「利用上限」(使用上限)剩下的上限金额。没设上限的密钥显示「上限なし」(无上限)
「このキーの利用額」(这把密钥的使用金额)用这把密钥花掉的金额合计
「最終利用」(最后使用)最后一次使用的时间。还没用过的密钥显示「未使用」
「作成日時」(创建时间)创建密钥的时间

密钥的操作

列表每一行右端的菜单里,可以做下面这些操作。

操作结果
「キーを表示」(显示密钥)显示完整的密钥
「名前を変更」(修改名称)修改密钥的名称。以前的记录仍按旧名称显示
「利用上限を変更」(修改使用上限)修改这把密钥今后能用的金额。留空就是无上限
「停止」(停用)停止用这把密钥调用。点「再開」(恢复)可以恢复
「削除」(删除)删除密钥。无法恢复。为了确认,要输入密钥的名称

用已停用或已删除的密钥调用,会返回 HTTP 401。删除后,以前的使用记录仍保留在调用记录里。

密钥泄露时,请马上停用或删除这把密钥,然后发行一把新的。

使用上限

发行时或在「利用上限を変更」里填的「利用上限」,是这把密钥能用的金额上限。用多少减多少,不会自动恢复。

达到上限的密钥,状态会变成「上限に達した」(已达上限),那一行会出现「利用上限を変更」按钮。调高上限后,密钥会自动恢复使用。不需要更换程序里的密钥。

接近上限、达到上限时返回的错误,见上限与速率限制。

查看使用情况

在菜单的「利用状況」(使用情况)里选择时间段,可以看到下面这些项目。时间是日本时间。

项目内容
「期間の合計」(期间合计)使用金额、请求数、token 数
「日別の利用額」(每天的使用金额)每天使用金额的图表
「モデル別」(按模型)每个模型的请求数和使用金额
「キー別」(按密钥)每个密钥名称的请求数和使用金额

合计、按天、按模型的数字每小时汇总一次。最新的调用最多要 5 分钟才会反映出来。

查看调用记录

菜单的「呼び出し履歴」(调用记录)里,按从新到旧显示每一次调用的记录。不显示请求和模型回答的正文。记录了哪些项目,见数据处理。

项目内容
列表时间、结果(成功、失败)、密钥、模型、金额、请求 ID
详情失败的内容和处理方法、HTTP 状态码、输入 token、输出 token、耗时、是否流式输出
「絞り込み」(筛选)时间段、结果、密钥、模型 ID、请求 ID
「CSV を書き出す」(导出 CSV)把一个月的记录导出为 CSV。不含请求正文

记录可能需要几秒才会出现。

视频生成的任务

视频生成的任务(视频生成)每个任务显示为一行。

项目内容
状态「待機中」(等待中)、「生成中」(生成中)、「完了」(完成)、「失敗・返金済み」(失败、已退款)之一。「生成中」期间同时显示提交后经过的时间(例:生成中 · 1 分 20 秒)
金额生成结束前,是提交时扣除的估算金额。结束后,变成重新计算的金额。失败的任务已全额退款
「開く」(打开)在已完成的任务那一行。打开生成的视频
「期限切れ」(已过期)显示在超过提供方保留文件期限的任务那一行。视频已经打不开

余额与充值

在菜单的「残高とチャージ」(余额与充值)里,可以看到当前余额、其中赠送的部分和最近的到期日。

项目内容
「内訳」(明细)充值部分、赠送部分各自的发放日、发放金额、剩余和有效期。从有效期最近的开始使用
「チャージ履歴」(充值记录)充值的日期、金额(含税)、收据

明细和充值记录会在会员网站 Echo AI Hub 公开后显示。

充值步骤如下。

  1. 在「残高とチャージ」里点「チャージする」(充值)。余额不足或为 0 时,各页面上方那一行里的「チャージする」也能打开
  2. 选择金额,点「お支払いへ進む」(前往付款)。这个画面上写着各金额充值后的余额、付款前要确认的事项(加到余额的金额、到账时间、有效期、退款),还有「利用規約」(使用条款)、「特定商取引法に基づく表記」(依据特定商业交易法的标示)的链接
  3. 跳转到 Stripe 的付款页面,用信用卡支付。收据由 Stripe 通过邮件发送
  4. 支付完成后,会回到点「チャージする」的那一页。余额更新可能需要几秒到 1 分钟左右。更新后页面会自动刷新

能充值的金额、有效期、请求书和收据,见价格与充值。

信息来源

内容来源确认日期
菜单、发行密钥的页面和列表的项目、密钥的操作、修改使用上限和恢复、使用情况、调用记录、余额与充值的项目、刚注册时的显示Echo Token Station 的控制台(2026-09-28 时的页面)2026-09-28
调用记录里视频生成任务的显示(状态、经过时间、金额、「開く」、「期限切れ」)Echo Token Station 控制台的规格(2026-10-02 时)2026-10-02
充值步骤(选择金额的画面、跳转到 Stripe 的付款页面、支付后回到的页面),充值记录的项目Echo 验证环境中的实测。用测试服务器代替会员网站 Echo AI Hub 和 Stripe2026-10-01
已停用、已过期、已删除的密钥,以及用完上限的密钥返回 401Echo 验证环境中的实测。使用与正式环境相同的中转设置,并用返回测试响应的服务器代替上游 API2026-09-28
一个账号能发行的密钥数Echo 中转服务器的设置(2026-09-28 时)2026-09-28