API 密钥与使用情况
汇总在控制台发行、显示、停用和删除 API 密钥,使用上限,使用情况和调用记录的看法,以及余额与充值。
控制台(https://token.echohub.io/console )是管理 API 密钥和使用情况的页面。用 Echo AI Hub 的账号登录。
控制台只有日文。本页里控制台上的名称用日文写,括号里是中文说明。
| 菜单 | 能做的事 |
|---|---|
| 「はじめに」(入门) | 按顺序确认余额、API 密钥和第一次调用这三项。第一次调用成功之前会显示 |
| 「利用状況」(使用情况) | 查看每个时间段的使用金额、请求数、token 数,以及按天、按模型、按密钥的使用情况 |
| 「呼び出し履歴」(调用记录) | 查看每一次调用的记录。可以筛选,也可以导出 CSV |
| 「APIキー」(API 密钥) | 发行、显示密钥,修改名称和使用上限,停用和恢复,删除 |
| 「残高とチャージ」(余额与充值) | 查看余额、明细和充值记录,进行充值 |
| 「モデルと料金」(模型与价格) | 打开模型一览 |
| 「ドキュメント」(文档) | 打开本文档 |
刚注册完时,会显示「API の利用を準備しています」(正在准备 API 的使用)。准备好后,页面会自动切换。时间较长时,请过几分钟重新打开页面。
发行 API 密钥
- 打开菜单里的「APIキー」,点「キーを発行」(发行密钥)
- 在「名前」(名称)里填一个能看出用途的名称(例:生产服务器)。最多全角 16 个字、半角 50 个字。不能和已有的密钥同名
- 要限制这把密钥能用的金额时,在「利用上限(円)」(使用上限(日元))里填金额。不填时,可以在账号余额的范围内使用
- 点「発行する」(发行),会显示密钥。点「キーをコピー」(复制密钥),保存到安全的地方
- 密钥是以
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 公开后显示。
充值步骤如下。
- 在「残高とチャージ」里点「チャージする」(充值)。余额不足或为 0 时,各页面上方那一行里的「チャージする」也能打开
- 选择金额,点「お支払いへ進む」(前往付款)。这个画面上写着各金额充值后的余额、付款前要确认的事项(加到余额的金额、到账时间、有效期、退款),还有「利用規約」(使用条款)、「特定商取引法に基づく表記」(依据特定商业交易法的标示)的链接
- 跳转到 Stripe 的付款页面,用信用卡支付。收据由 Stripe 通过邮件发送
- 支付完成后,会回到点「チャージする」的那一页。余额更新可能需要几秒到 1 分钟左右。更新后页面会自动刷新
能充值的金额、有效期、请求书和收据,见价格与充值。
信息来源
| 内容 | 来源 | 确认日期 |
|---|---|---|
| 菜单、发行密钥的页面和列表的项目、密钥的操作、修改使用上限和恢复、使用情况、调用记录、余额与充值的项目、刚注册时的显示 | Echo Token Station 的控制台(2026-09-28 时的页面) | 2026-09-28 |
| 调用记录里视频生成任务的显示(状态、经过时间、金额、「開く」、「期限切れ」) | Echo Token Station 控制台的规格(2026-10-02 时) | 2026-10-02 |
| 充值步骤(选择金额的画面、跳转到 Stripe 的付款页面、支付后回到的页面),充值记录的项目 | Echo 验证环境中的实测。用测试服务器代替会员网站 Echo AI Hub 和 Stripe | 2026-10-01 |
| 已停用、已过期、已删除的密钥,以及用完上限的密钥返回 401 | Echo 验证环境中的实测。使用与正式环境相同的中转设置,并用返回测试响应的服务器代替上游 API | 2026-09-28 |
| 一个账号能发行的密钥数 | Echo 中转服务器的设置(2026-09-28 时) | 2026-09-28 |