智元 Fast API

Appearance

ViteConf Logo

 

智元 IIM

 

快速开始 ​

从0到1只需60秒 ​

如何快速熟悉整个系统 ​

如果你是第一次接触 智元 Fast API, 建议不要一上来就把所有功能都点一遍, 按下面这条主线熟悉会更快。

第一步: 先理解系统里有哪几类角色 ​

  • 管理员: 负责整个系统的模型、用户、应用、站点和配置管理
  • 代理商: 负责管理自己名下的用户、站点和运营内容
  • 普通用户: 负责调用接口或直接使用前台页面与智能助手能力

如果你只是想先把系统跑起来, 前期主要关注管理员端即可。

第二步: 先建立模型能力 ​

系统的大部分功能都围绕模型展开, 所以建议先完成这几步:

  1. 新建 提供商, 确认模型来自哪个平台
  2. 配置 模型管理, 建立真正可用的模型
  3. 如有需要, 再补充 模型代理 和 密钥管理

这里建议你顺手把模型的价格规则一起配置好, 现在已经支持多计费项、阶梯计费、时段计费以及更细的差异化定价规则。

如果模型没有配置好, 后面的很多权限、额度和调用流程都无法真正使用。

第三步: 再建立对外调用入口 ​

当模型可用后, 再继续配置对外调用能力:

  1. 创建 应用, 用来区分不同业务系统或不同项目
  2. 创建 应用密钥, 给具体调用方分发独立凭证
  3. 按需要配置模型权限、额度、分组和 IP 规则

这样你的业务系统就可以通过统一 API 入口开始调用。

第四步: 再配置用户、分组和会员体系 ​

如果你要把系统开放给普通用户或客户使用, 建议继续配置:

  1. 分组管理, 用来打包模型权限、折扣和额度规则
  2. 用户管理, 给用户开通账号并分配权限
  3. 会员等级, 配置套餐、折扣和升级降级规则
  4. 套餐管理, 配置可购买、可兑换、可续费的额度套餐, Plus版和专业版支持

这一部分主要决定“谁能用什么、能用多少、按什么规则收费”, 如果你已经配置了分组时段折扣, 这里也会一起影响最终计费体验。

第五步: 最后完善前台体验和运营内容 ​

当基础调用链路跑通后, 再继续补这些内容:

  1. 站点配置, 配置标题、Logo、背景图、公告和文档
  2. 登录注册, 确认各端登录方式和注册规则
  3. 通知管理, 配置消息通知、模板和站内信
  4. 智能助手, 体验聊天、画图、视频和语音等前台能力
  5. 在线充值, 配置充值支付、订单状态、补单和退款流程, Plus版和专业版支持
  6. 兑换码, 配置额度兑换、套餐兑换和活动卡密发放, Plus版和专业版支持
  7. 邀请返佣, 配置用户增长和返佣激励路径
  8. 工单管理, 配置用户反馈和售后支持入口

这样系统才会从“可调用”变成“可运营、可展示、可直接给用户使用”。

第六步: 学会看数据和排查问题 ​

建议你至少熟悉这几个页面:

  • 仪表盘: 看整体趋势和提醒
  • 数据看板: 看调用趋势、花费分布、异常率和模型排行
  • 监控中心: 看实时/历史性能、成功率、错误数和响应耗时
  • 日志管理: 看每一次调用详情
  • 财务中心: 看账单和交易记录
  • 套餐管理: 看套餐购买、兑换、续费和额度使用, Plus版和专业版支持
  • 在线充值: 看充值订单、状态查询、补单和退款流程, Plus版和专业版支持
  • 兑换码: 看额度兑换、套餐兑换和使用记录, Plus版和专业版支持
  • 工单管理: 看用户问题处理和售后沟通
  • 任务中心: 看异步任务执行情况
  • 常见问题: 遇到问题时优先看这里

如果你后面发现“模型明明配了却不能用”, 通常优先检查模型、分组、应用、应用密钥和用户权限是否串起来了。

推荐的熟悉顺序 ​

如果你想最快熟悉整套系统, 推荐按这个顺序看:

  1. 为什么选择
  2. 常见问题
  3. 模型管理
  4. 应用管理
  5. 应用密钥
  6. 分组管理
  7. 用户管理
  8. 站点配置
  9. 日志管理
  10. 数据看板
  11. 监控中心
  12. 套餐管理
  13. 在线充值
  14. 兑换码
  15. 工单管理

Docker部署 ​

  1. 执行部署命令, 注意: 请部署在数据盘上, 或者部署在可用最大的那个盘上
bash
curl -sSO https://deploy.fastapi.app/install.sh && sudo bash install.sh
bash
curl -sSO https://deploy.fastapi.app/install.sh && sudo bash install.sh
bash
curl -sSO https://deploy.fastapi.app/install.sh && sudo bash install.sh

  1. 服务访问地址
    管理端: http://ip:port/admin
    用户端: http://ip:port/login
    代理商: http://ip:port/reseller
    API接口: http://ip:port/v1/chat/completions

  2. 管理员账密: 无默认账密, 首次登录时输入的账号和密码将自动创建为管理员的账号和密码
    注意: 避免使用弱口令, 推荐使用大小写字母+数字+符号的组合
    重要: 首次进入系统后, 首先到「配置管理-通用-管理员登录」修改登录入口为复杂自定义路径, 这能有效隐藏管理端入口, 抵御扫描攻击, 提升系统安全性的关键措施

  3. 模型管理->同步, 参数如下
    模型接口: https://api.fastapi.ai/v1/models
    应用密钥: sk-FastAPI1DKp0fzcD0Bf0sOJV1IJW1Fjnn0y0rXV0GNb1aolA

  4. 恭喜您已安装完成, 接下来请尽情享受AI之旅吧!

手动部署 ​

  1. 需提前安装好Redis和MongoDB以及Docker服务, 还需安装以下必要命令
bash
yum install -y wget zip unzip
bash
apt update
apt install -y wget zip unzip
bash
apt-get update
apt-get install -y wget zip unzip
  1. 下载安装包, 注意: 请下载到数据盘上, 或者下载到可用最大的那个盘上
bash
wget -O community-latest.zip https://community.deploy.fastapi.app/community-latest.zip && unzip -o community-latest.zip
bash
wget -O plus-latest.zip https://plus.deploy.fastapi.app/plus-latest.zip && unzip -o plus-latest.zip
bash
wget -O pro-latest.zip https://pro.deploy.fastapi.app/pro-latest.zip && unzip -o pro-latest.zip

  1. 修改fastapi-admin\manifest\config\config.yaml文件的Redis和MongoDB配置
    bin目录下执行: chmod 777 ./*
    resource目录下执行: chmod 777 ./*.sh

  2. 修改fastapi\manifest\config\config.yaml文件的Redis和MongoDB配置
    bin目录下执行: chmod 777 ./*

  3. 执行fastapi-admin和fastapi启动服务命令
    注意: 命令中有$PWD变量, 需要在部署目录下执行, 或者手动修改目录映射

bash
docker run --name fastapi-admin -d -p 8080:8080 \
  --network host \
  --restart=always \
  -v /etc/localtime:/etc/localtime:ro \
  -v $PWD/fastapi-admin:/app \
  iimeta/fastapi-admin:latest
bash
docker run --name fastapi -d -p 8000:8000 \
  --network host \
  --restart=always \
  -v /etc/localtime:/etc/localtime:ro \
  -v $PWD/fastapi:/app \
  iimeta/fastapi:latest
bash
docker run --name fastapi-admin -d -p 8080:8080 \
  --network host \
  --restart=always \
  -v /etc/localtime:/etc/localtime:ro \
  -v $PWD/fastapi-admin:/app \
  registry.cn-hangzhou.aliyuncs.com/iimeta/fastapi-admin:latest
bash
docker run --name fastapi -d -p 8000:8000 \
  --network host \
  --restart=always \
  -v /etc/localtime:/etc/localtime:ro \
  -v $PWD/fastapi:/app \
  registry.cn-hangzhou.aliyuncs.com/iimeta/fastapi:latest

  1. 服务访问地址
    管理端: http://ip:8080/admin
    用户端: http://ip:8080/login
    代理商: http://ip:8080/reseller
    API接口: http://ip:8000/v1/chat/completions

  2. 管理员账密: 无默认账密, 首次登录时输入的账号和密码将自动创建为管理员的账号和密码
    注意: 避免使用弱口令, 推荐使用大小写字母+数字+符号的组合
    重要: 首次进入系统后, 首先到「配置管理-通用-管理员登录」修改登录入口为复杂自定义路径, 这能有效隐藏管理端入口, 抵御扫描攻击, 提升系统安全性的关键措施

  3. 模型管理->同步, 参数如下
    模型接口: https://api.fastapi.ai/v1/models
    应用密钥: sk-FastAPI1DKp0fzcD0Bf0sOJV1IJW1Fjnn0y0rXV0GNb1aolA

  4. 恭喜您已安装完成, 接下来请尽情享受AI之旅吧!

其他事项 ​

  1. 专业版: 系统管理->许可信息中点击激活并输入产品密钥: 请联系作者获得产品密钥
    未激活产品无法启动fastapi服务

  2. 日志输出级别默认是debug, 可以按需修改config.yaml中的logger.level配置
    日志输出级别有: debug, info, error, all

  3. 更新版本步骤, 注意: 以下更新步骤只适合小版本的更新, 大版本更新请按 升级说明 中步骤操作

  • 2.1. 更新fastapi在fastapi/bin目录下执行: ./deploy.sh

  • 2.2. 更新fastapi-admin在fastapi-admin/bin目录下执行: ./deploy.sh

  • 2.3. 更新fastapi-admin的web页面在fastapi-admin/resource目录下执行: ./deploy.sh

  • 注意: 更新会自动拉取最新程序包并重启容器, 更新后发现有异常想回滚, 执行: ./restore.sh

智元 Fast API

Copyright © 2023-2026 IIM. All Rights Reserved.