快速开始

从0到1只需60秒

如何快速熟悉整个系统

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

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

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

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

第二步: 先建立模型能力

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

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

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

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

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

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

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

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

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

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

1. 分组管理, 用来打包模型权限、折扣和额度规则
2. 用户管理, 给用户开通账号并分配权限
3. 会员等级, 配置套餐、折扣和升级降级规则

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

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

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

1. 站点配置, 配置标题、Logo、背景图、公告和文档
2. 登录注册, 确认各端登录方式和注册规则
3. 通知管理, 配置消息通知、模板和站内信
4. 智能助手, 体验聊天、画图、视频和语音等前台能力

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

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

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

• 仪表盘: 看整体趋势和提醒
• 日志管理: 看每一次调用详情
• 财务中心: 看账单和交易记录
• 任务中心: 看异步任务执行情况
• 常见问题: 遇到问题时优先看这里

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

推荐的熟悉顺序

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

1. 为什么选择
2. 常见问题
3. 模型管理
4. 应用管理
5. 应用密钥
6. 分组管理
7. 用户管理
8. 站点配置
9. 日志管理

Docker部署

1. 执行部署命令, 注意: 请部署在数据盘上, 或者部署在可用最大的那个盘上

CentOS

curl -sSO https://deploy.fastapi.app/install.sh && sudo bash install.sh

Ubuntu

curl -sSO https://deploy.fastapi.app/install.sh && sudo bash install.sh

Debian

curl -sSO https://deploy.fastapi.app/install.sh && sudo bash install.sh

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

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

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

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

手动部署

0. 需提前安装好Redis和MongoDB以及Docker服务, 还需安装以下必要命令

CentOS

yum install -y wget zip unzip

Ubuntu

apt update
apt install -y wget zip unzip

Debian

apt-get update
apt-get install -y wget zip unzip

1. 下载安装包, 注意: 请下载到数据盘上, 或者下载到可用最大的那个盘上

社区版

wget -O community-latest.zip https://community.deploy.fastapi.app/community-latest.zip && unzip -o community-latest.zip

Plus版

wget -O plus-latest.zip https://plus.deploy.fastapi.app/plus-latest.zip && unzip -o plus-latest.zip

专业版

wget -O pro-latest.zip https://pro.deploy.fastapi.app/pro-latest.zip && unzip -o pro-latest.zip

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

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

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

fastapi-admin

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

fastapi

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

fastapi-admin(备用)

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

fastapi(备用)

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

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

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

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

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

其他事项

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

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

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

• 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