AI POOL
使用指南
官网
使用指南
官网
简体中文

快速开始

本指南将帮助您快速开始使用 AI-POOL，从注册账户到创建第一个 API 令牌。

注册账户

  1. 访问 AI-POOL 平台
  2. 点击右上角的「注册」按钮
  3. 填写注册信息：
    • 手机号
    • 密码（建议使用强密码）
  4. 完成注册并登录

账户充值

在使用 AI 模型服务之前，您需要先为账户充值。

  1. 登录后，点击导航栏的「钱包」或「充值」按钮
  2. 选择充值金额：
    • 快速选择：¥10、¥50、¥100、¥500
    • 自定义金额：¥10 - ¥10,000（仅支持整数）
  3. 点击「立即充值」生成支付二维码
  4. 使用支付宝或微信扫码支付
  5. 支付成功后，余额将实时到账

💡 提示：首次使用建议先充值小额金额进行测试。

创建 API 令牌

API 令牌是调用 AI-POOL 服务的凭证，您需要创建至少一个令牌才能开始使用。

步骤 1：进入令牌管理页面

  1. 登录 AI-POOL 平台
  2. 点击左侧导航栏的「令牌管理」
  3. 点击右上角的「创建令牌」按钮

步骤 2：配置令牌信息

在创建令牌对话框中，填写以下信息：

基本信息

  • 令牌名称：为令牌设置一个易于识别的名称（如：生产环境、测试环境、项目A等）
  • 令牌描述（可选）：添加详细说明，方便后续管理

额度设置

  • 使用额度：设置该令牌的最大可用额度
    • 留空表示不限制
    • 设置具体金额可防止超支

有效期设置

  • 过期时间（可选）：设置令牌的有效期
    • 留空表示永久有效
    • 建议为测试令牌设置较短的有效期

模型权限

  • 可用模型：选择该令牌可以访问的 AI 模型
    • 可以选择一个或多个模型
    • 建议根据实际需求选择，避免不必要的权限

步骤 3：保存并获取令牌

  1. 确认信息无误后，点击「创建」按钮
  2. 令牌创建成功后，会显示完整的 API Key
  3. 重要：请立即复制并妥善保存 API Key，出于安全考虑，后续将无法再次查看完整密钥
  4. 点击「复制」按钮将 API Key 复制到剪贴板

步骤 4：测试令牌

创建令牌后，您可以立即开始使用。以下是一个简单的调用示例：

curl https://ai-gate.haozcloud.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [
      {
        "role": "user",
        "content": "Hello, AI-POOL!"
      }
    ]
  }'

将 YOUR_API_KEY 替换为您刚才创建的 API Key。

令牌管理

查看令牌列表

在令牌管理页面，您可以看到所有已创建的令牌，包括：

  • 令牌名称和描述
  • 创建时间
  • 过期时间
  • 使用额度和剩余额度
  • 状态（启用/禁用）
  • 关联的模型数量

编辑令牌

  1. 在令牌列表中找到需要编辑的令牌
  2. 点击操作列的「编辑」按钮
  3. 修改令牌信息（名称、描述、额度、过期时间、模型权限）
  4. 点击「保存」确认修改

⚠️ 注意：编辑令牌不会改变 API Key 本身，原有的 API Key 仍然有效。

启用/禁用令牌

如果您需要临时停用某个令牌：

  1. 在令牌列表中找到目标令牌
  2. 点击状态开关，将令牌设置为「禁用」
  3. 禁用后，使用该令牌的 API 调用将被拒绝
  4. 需要恢复时，再次点击开关即可启用

删除令牌

如果不再需要某个令牌：

  1. 在令牌列表中找到目标令牌
  2. 点击操作列的「删除」按钮
  3. 确认删除操作
  4. 删除后，该 API Key 将立即失效

⚠️ 警告：删除令牌是不可逆操作，请确保没有应用正在使用该令牌。

监控使用情况

创建令牌后，建议定期查看使用情况：

  1. 在「个人中心」查看整体使用统计
  2. 在「令牌管理」查看各令牌的额度消耗
  3. 在「余额流水」查看详细的消费记录
  4. 在「审计日志」追踪每次 API 调用

下一步

现在您已经成功创建了第一个 API 令牌，可以：

最佳实践

令牌命名规范

  • 使用有意义的名称，如「生产环境-主服务」「测试环境」
  • 为不同项目或环境创建独立的令牌
  • 添加详细的描述信息

安全建议

  • 不要在代码中硬编码 API Key
  • 使用环境变量或配置文件存储 API Key
  • 定期轮换生产环境的 API Key
  • 为测试令牌设置较低的额度限制
  • 不再使用的令牌应及时删除

额度管理

  • 为每个令牌设置合理的额度上限
  • 定期检查令牌使用情况
  • 余额不足时及时充值
  • 使用额度限制防止意外超支

权限控制

  • 遵循最小权限原则，只授予必要的模型访问权限
  • 不同用途的令牌配置不同的模型权限
  • 定期审查令牌权限配置
大纲