AI 分身应用接入指南
收藏我的收藏
收藏如何开发上线一个 AI 分身
一、账号准备
- 1.账号注册&入驻
如开发者已有平台账号，无需重复注册，直接进入流程「2.账号加白」即可。
（1）注册开发者平台账号
详细注册流程：👉注册流程
（2）开发者类型认证
开发者类型 | 资质类型 | 创建 AI 分身数量 |
企业/个体工商户/党政机关/事业单位/社会组织/其他组织 | 具体资质可查询：入驻流程 | 可创建 50 个分身应用 |
个人 | 身份证照片 | 可创建 5 个分身应用 |
注：开发者认证是创建 AI 分身应用的必要条件，请务必确认已认证成功。
- 2.账号加白
认证成功后，开发者向平台对接人提供「开放平台账号名称＋注册邮箱/手机号」，平台把账号加入白名单后，开发者可看到 AI 分身创建入口。
二、应用准备
- 1.创建 AI 分身应用（加白可见）
第一步：登录开发者工作台，找到 AI 分身应用 tab。
第二步：创建 AI 分身应用。
填写名称即可完成应用创建。 （AI分身应用名称具有全局唯一性）
创建完成后在开发者工作台找到该应用，点击“设置-基础设置”，可查看应用基本状态。
第三步：绑定抖音号。
AI 分身仅支持与同主体的抖音号进行绑定。
可在「设置-基础设置」页面发起绑定抖音号 。
- •若抖音号为个人实名认证，则需抖音号扫码确认授权。
- •若抖音号已认证为企业机构账号，点击「前往操作」后会进入到「账号中心-抖音企业机构账号」管理列表，在这个列表内你可以管理由当前开发者账号创建或认证的抖音企业机构账号。
第四步：完成开发配置。
AppSecret：开发者可在密钥管理页面进行 AppSecret 的启用、重置以及禁用。
- 2.开通抖音云并初始化资源
AI 分身的后端服务需要用到接口服务、大模型能力、存储组件，需前往抖音云控制台完成如下操作。
步骤 | 操作详情 | |||||
Step1：为 AI 分身应用开通抖音云 | 注：个人开发者如未完成银行卡四要素实名认证，需要补充认证信息。完成后可点击开通 | |||||
选择应用 | 个人补充四要素 实名认证 | 为应用开通抖音云 | ||||
Step2：新建服务并开启本地调试 |
| |||||
新建服务 | 本地调试 | |||||
Step3：开通大模型 | 点击「行业解决方案-大模型」，点击「开通」。 | |||||
开通大模型 | 获取模型推理节点 | |||||
Step4：开通存储组件【可选】 | 如需保存业务数据，开发者可开通如下存储组件 | |||||
开通 MySQL | ||||||
- 3.为 AI 分身应用关联开发者服务
- •如在抖音云已创建服务：开发者可到「开发-开发配置-抖音云服务 tab」，选择该应用在抖音云已创建的服务。
已创建服务
刷新页面后关联服务
完成配置
- •如在抖音云未创建服务：请先点击「抖音云」按钮跳转到抖音云，点击「新建服务-自定义创建」完成服务创建。回到抖音开放平台的「开发配置」页面刷新后关联服务。
未创建服务
抖音云服务列表
自定义新建服务
刷新页面后关联服务
三、分身开发
前往 IDE 开发应用：
IDE 即抖音 AI 分身开发者工具，是面向抖音 AI 分身开发者推出的集成开发环境，支持开发、调试、上传等基本功能，支持在 Windows、Mac 平台上运行，旨在帮助开发者更高效地开发抖音 AI 分身应用。
调试前需先完成如下环境准备：
- •安装 vscode Golang、Java 调试扩展，配置扩展
- ◦如果是 go 语言，需要本地安装 dlv 调试器，安装参考
- •本地安装 Docker 环境，推荐 Windows/Mac/Linux 用户安装
Docker Desktop软件（下载链接），并打开软件保证 Docker 服务正常启动。- •前往「抖音云控制台-服务列表」开启了本地调试
开发完成后，点击右上角「部署」进行上传即可获得一个测试版本，可打开抖音 App 扫码体验。
四、发布上线
- 1.版本提审、发布
（1）在开放平台「开发-版本信息」，选择测试版本提交审核，预计 3 个工作日内获得审核结果。
（2）通过审核后，可选择「立即全量发布」或「灰度发布」。
若为灰度发布，需根据指引，前往抖音云控制灰度发布比例。
因为 dev、prod 环境资源完全隔离，请勿在代码中写死大模型推理节点 ID、存储组件配置等信息，否则会导致全量发布到 prod 环境后服务不可用！请通过环境变量方式进行读取。
（3）完成发布后，可查看「线上版本」信息。
- 2.分身开发完毕后使用分身
（注意：分身需开发完毕，否则会显示分身在构建中。）
（2）支持使用如下功能。
- a.【状态】模块：进行分身状态的编辑，支持将分身状态调整。
- i.私密·仅自己可互动：AI 分身互动入口将不会显示在抖音，已开通的 AI 分身场景也将被停用。
- ii.公开·所有人可互动：AI 分身互动入口将显示在「抖音-我」的头像中，支持点击发起互动；AI 分身也可以被添加到更多场景中互动。
- b.【场景】模块，支持分场景开关开启，管理分身在评论、群聊等场景是否可启用。
- c.【人设】编辑：为分身量身定做人物设定，在分身回复中凸显性格特征。
AI 分身应用场景参考
以下仅作示例参考，场景持续开放中。
抖音账号主页 带“AI 聊天”角标的头像 | 搜索（可申请） | AI 搜（建设中） | 私信（建设中） | 群聊（建设中） | 评论区（建设中） | 直播（建设中） AI 分身弹幕回复；输入框“AI”入口 |
| | | | | | |
开放能力一览
能力归类 | 能力名 | 使用方式 | 能力文档 | 接口文档 |
模型基础能力 | Prompt enginerring | 高代码 无需提供开放能力，开发者自行实现 | - | / |
知识库能力 | 高代码 可选使用 | |||
调用向量化模型
| 高代码 可选使用 | - | ||
调用语言大模型
| 高代码 | - | ||
长期记忆能力
| 高代码 可选使用 | |||
技能供给能力 | 抖音外域技能配置能力
| 开发者在平台配置后，可通过高代码使用。 | | |
分身服务 | 开场白
| 提供标准接口协议，开发者自行实现。 | - | |
流式对话
| 提供标准接口协议，开发者自行实现。 | - | ||
消息卡片
| 提供标准接口协议，开发者自行实现。 | - |
常见问题
- 1.抖音云服务计费问题
（1）费用预估
计费模式参考如下文档，如有疑问可反馈至在线客服/对接运营/对接商务。
- •产品定价：产品定价__抖音开放平台
- •模型服务计费：模型服务计费--火山方舟大模型服务平台- 火山引擎
AI 分身云服务费用预估：
类型 | 分模块 | 可选/必要 | 计费模式 | 定价及举例 | AI 分身 DAU 100 费用预估 |
大模型费用 | 豆包大语言模型 | 必要 | 按实际调用量付费，无调用量就不付费 | 按 tokens 使用量（输入文本+输出文本）计费，每小时出账，按量后付费，以 Doubao-pro-32k 模型为例（AI 分身应用一期上线的能力）属于豆包大模型的高阶版，输入 80 元/亿 tokens，输出 200 元/亿 tokens。 举例：按照每天 100 人与 AI 分身对话，每轮对话 3 次「输入输出各 3 次」，每轮对话平均产生 1000 tokens 的输入，100 tokens 输出
| 9 元/月 |
后端服务部署 | 计算服务 | 必要 | 按实际调用量付费，无调用量就不付费 | 按实际调用量付费 1 元起。取 2 个案例如下
| 1 元/月 |
数据库 | 可选
| 支持按时长付费，或者包月。租用模式，无调用量也要付费 | 数据库最低配置如下，可选择按量使用或者包月，包月成本能降低 30%以上
| 264 元/月
| |
总费用 | | | | | 必要总支出 10 元/月 可选总支出 264 元/月 |
（2）云服务充值付费流程
抖音云应用主体与 AI 分身应用保持一致，充值时不限来源，可个人、企业转账。开发票仅限于当前实名认证主体。
如需通过不同实名认证主体（母公司、服务商代付）支付和开发票，需要在火山引擎注册渠道账号后，将 AI 分身应用授权关联渠道后，从渠道账户划拨资金给 AI 分身应用使用。接入流程请联系对接运营。
查看账单明细 | 充值 | 开发票 | |
- 2.模型是否一定要部署在抖音域内？
抖音 AI 分身构建中会使用到抖音的视频、用户对话等数据，用于后端服务及大模型。所以基于抖音侧合规风险考量，需要将后端服务和大模型部署在抖音云。
- 3.可开放至开发者的数据内容包括哪些？
开发者可提供具体的希望开放的数据需求清单，平台会根据需求情况，评估后反馈是否可提供。
- 4.抖音账 号和主体和 AI 分身应用间的对应关系是什么？
- •1 个企业主体最多可创建 50 个 AI 分身应用。
- •1 个人主体（身份证）最多可创建 5 个 AI 分身应用，且 AI 分身应用仅可绑定唯一的同资质抖音账号。
- •「抖音账号」和「AI 分身应用」为一一对应且永久绑定的关系。
- 5.当前接入 AI 分身能力支持哪些模型？
支持豆包系列模型，开通大模型时默认开通 doubao-lite-32k、doubao-pro-32k、 doubao-embedding-large、doubao-embedding 4 款大模型。如有豆包系列其他版本模型诉求，可联系运营申请开通。
- 6.如何实现模型语料库调优？
可通过搭建 AI 分身知识库实现调优。AI 分身提供知识库能力，除平台导入的达人相关数据外，支持将外部数据导入。开发者可将业务自身沉淀的知识通过接口导入。
- 7.一个 AI 分身支持关联几个服务？
目前，一个 AI 分身应用仅支持关联一个服务，服务关联后才能进行上传、部署、接收消息。
- 8.function Calling 支持情况
在抖音云开通大模型时，默认创建的推理节点关联的版本 240828 FC 能力弱，如有 function calling 需求建议新建推理节点并绑定 functioncall-preview 版本。详情见：Function Calling 使用说明
模型名称 | 模型版本 | FC 能力 | 说明 |
doubao-pro-32k | functioncall-preview | 强 | 动态更新的 functioncall 模型，使用效果表现更好 |
functioncall-240815 | 强 | 效果好，并且推理速度比 preview 快 | |
240828 | 弱 | | |
functioncall-240515 | 强 | 通用能力有所降低 | |
240615 | 一般 | 通用能力好 | |
240515 | 一般 | ||
character-240528 | 一般 | | |
doubao-lite-32k | 240428 | 弱 | |
- 9.如何为应用添加协作者？
如需对已创建应用添加操作人，需应用的超级管理员在账号中心将对应人员设置为管理员或协作者。
账号中心操作位置：账号中心 -> 成员写作 -> AI 分身应用 -> 具体应用 -> 选择管理员/协作者 -> 选择相关权限。问题反馈
- 10.如遇到其他问题，目前可以通过以下方式进行反馈：
第二步：可在群聊中询问相关问题，机器人将推送相似问题，点击可查看解决方案。如没有类似问题答复，可根据需求转人工服务，填写问题描述、问题类型选择「AI 分身」，并选择对应二级标签，将有对应值班同学解答问题。
