智惠API网站功能用户使用手册

智惠API网站功能用户使用手册

本文介绍登录智惠API http://api.api2cn.com/ 后，左侧“我的账户”区域常用菜单的用途，以及第一次调用 API 的完整流程。

一、第一次使用

  1. 注册或登录账户。
  2. 打开“仪表盘”，确认账户余额、API 密钥数量和近期用量。
  3. 进入“API 密钥”，点击“创建密钥”。填写名称并选择可用分组，按页面提示保存。
  4. 立即复制新生成的 API Key。密钥只应保存在自己的密码管理器或本地安全配置中，不要发到群聊、截图、公开仓库或前端代码里。
  5. 在客户端中填写“API 密钥”页面显示的 API 端点。端点以页面显示内容为准，不要自行追加 /v1、/chat/completions 等路径。
  6. 在请求中使用以下认证头：
1
Authorization: Bearer YOUR_API_KEY

如果客户端支持自动获取模型，可以在“API 密钥”页面使用模型列表入口或复制对应的模型端点。模型名称、可用分组和访问权限以页面实际显示为准。

二、“我的账户”菜单说明

1. 仪表盘

查看账户总览，包括余额、API 密钥数量、今日请求、今日消费、Token 用量、最近使用记录和常用快捷操作。

第一次登录建议先查看这里；开始调用后，可从“最近使用”进入完整的“使用记录”。

2. API 密钥

这是日常使用最重要的页面，可以：

  • 创建、编辑和删除 API Key；
  • 为密钥选择分组；
  • 查看密钥状态、用量、有效期和配额；
  • 复制 API 端点和密钥；
  • 在支持时将密钥导入 CC Switch；
  • 对异常的限流或配额用量执行重置操作。

建议为不同应用创建不同的密钥，并使用容易识别的名称。发现密钥泄露时，应立即删除或撤销，再创建新的密钥。

3. 生图中心

用于在线提交图片生成任务。页面会提供任务参数和可复制的 Agent 调用说明。

使用前确认账户拥有生图权限KEY，并留意任务数量、模型和图片规格可能产生的费用。任务提交后可根据页面状态跟踪处理结果。

4. 使用记录

查看和分析 API 使用历史。常用信息包括：

  • 请求时间、模型、端点和请求状态；
  • 输入、输出、缓存和总 Token；
  • 标准费用、实际扣费和平均耗时；
  • 按 API Key、时间范围和模型筛选；
  • 导出 CSV 或 Excel。

排查扣费、请求失败或调用量异常时，先在这里缩小时间范围，再按密钥和模型查看明细。

5. 渠道状态

查看渠道当前可用性、延迟和近期状态。页面通常提供：

  • 渠道和分组名称；
  • 主模型；
  • 7 天可用率；
  • 最新延迟；
  • 7 天、15 天和 30 天状态详情。

调用失败时，可以先检查对应渠道是否处于 DEGRADED 或 UNAVAILABLE，再尝试其他可用模型或渠道。

6. 充值/订阅

用于充值余额或购买订阅套餐，具体显示哪些选项取决于站点配置。

一般流程是：

  1. 选择“充值”或“订阅”标签；
  2. 输入充值金额，或选择订阅套餐；
  3. 查看最终报价、赠送金额和会员权益；
  4. 选择支付方式并完成支付；
  5. 返回页面等待订单状态更新。

充值和订阅的最终到账金额以创建订单时的服务端报价为准。

7. 加密货币支付

使用 USDT 为账户余额充值。下单后请严格按照页面显示的金额、收款地址和网络转账：

  1. 输入充值金额并创建订单；
  2. 核对应付 USDT、收款地址和网络；
  3. 从钱包转账，避免使用不支持的网络；
  4. 等待区块确认和系统入账；
  5. 在当前页面或“我的订单”查看结果。

收款地址和网络以当前订单页面为准。转账前请再次核对，错误网络或错误地址通常无法追回。

8. 我的订单

查看充值、订阅和加密货币支付订单，包括订单编号、金额、实付金额、到账金额、支付方式、状态和创建时间。

对于仍在等待支付的订单，可以按页面提供的操作取消；遇到支付完成但余额未更新的情况，先刷新订单状态，再联系管理员或客服并提供订单编号。

9. 兑换

使用兑换码增加余额、并发数或试用权限：

  1. 输入完整兑换码；
  2. 注意兑换码区分大小写；
  3. 点击“兑换”；
  4. 在结果提示和“最近活动”中确认余额、并发数或订阅权限是否更新。

每个兑换码通常只能使用一次。兑换码不要公开分享；兑换失败时请检查字符、大小写和有效期。

10. 我的奖励

本站特色营销活动，集中查看和领取活动奖励，常见内容包括：

  • 每日签到；
  • 充值抽奖或活动奖励；
  • 排名奖励；
  • 奖励明细和发放记录。

每日签到是否开放、奖励金额和活动规则以页面显示为准。领取奖励后建议检查账户余额或奖励记录是否更新。

11. 个人资料

管理账户基本资料和安全设置，包括用户名、头像、密码、双因素认证和通知提醒等。

建议完成以下安全设置：

  • 使用独立且不重复的账户密码；
  • 为账户启用双因素认证（如果站点已开放）；
  • 保持邮箱等联系信息可用；
  • 不在公共设备上保留登录状态；
  • API Key 泄露时立即回到“API 密钥”页面撤销。

三、推荐使用顺序

注册登录后，可以按下面的顺序完成配置：

  1. 仪表盘：确认余额和账户状态。
  2. API 密钥：创建一个专用 Key，选择分组并复制端点。
  3. 可用渠道 / 渠道状态：确认可用模型和渠道健康情况。
  4. 客户端调用：填写端点、API Key 和模型名称。
  5. 使用记录：确认请求、Token 和扣费正常。
  6. 充值/订阅、加密货币支付或兑换：按需要补充余额或权限。
  7. 个人资料、我的奖励：完成安全设置并领取可用奖励。

四、常见问题

API 调用返回认证错误怎么办？

检查 API Key 是否完整、是否已删除或过期，确认请求头使用 Authorization: Bearer YOUR_API_KEY，并确认使用的是当前密钥页面显示的端点。

API 调用失败但密钥正常怎么办？

先检查“渠道状态”，再到“使用记录”查看具体状态码、模型和端点。也可以确认 API Key 是否绑定了正确分组，以及账户余额或订阅是否有效。

充值后余额没有变化怎么办？

先打开“我的订单”确认订单状态。支付处理中时等待系统确认；订单已完成但余额仍未更新，请保留订单编号并联系管理员。

请妥善保管账户密码和 API Key。任何需要提交密钥的排查，都只通过站点的安全渠道进行，不要在公开聊天中发送完整密钥。