创建虚拟人 · 接口验收

请输入用户名
自动上下文: 最近图片Id - 最近任务Id - 最近虚拟人Id - 最近消息Id - 最近模板Id -

阶段零 · 用户语言设置

0.1 设置当前 OAID 语言

语言下拉来自 dt_Language;设置后写入 dt_SetLanguage,后续创建虚拟人接口按 OAID 自动读取。

阶段一 · 进入创建页 & 选择形象

1.1 获取创建配置

界面要点:点击「创建虚拟人」入口时加载。返回可创建数量上限、当前数量、捏脸维度选项与默认值。

1.2 大众审美盲盒(每批数量可配置,可无限换批)

界面要点:「快速定制」标签页。用户点「换一批」时 BatchIndex+1,图库用完自动循环。

1.3 上传形象图片

界面要点:用户从相册选图上传,需勾选合规确认。上传成功返回 ImageId,可直接用于创建。

1.4 捏脸生成外貌(6维参数 → 向量检索图库)

界面要点:「自定义」标签页 6 个维度选择。下拉框显示中文,提交值仍为英文枚举名(与 DashVectorSearch 的 CompanionTags 一致),“随机”表示该维度提交 IGNORE。首次生成 BatchIndex=0,用户点「换一批」时 BatchIndex+1。生成张数由服务端 Web.config 统一配置。后端调用正式检索接口获取文件名,再拼接 OSS 图片域名;成功响应中的 ImageUrl 应类似 http://img.myaigirls.facailela.com/MyAIGirls/girl_0000000001.jpg

1.5 查询生成任务(轮询接口,兼容旧流程)

界面要点:当前为同步生成,提交时即返回 Success;此接口保留供客户端「提交→轮询」流程验证。

阶段二 · 收藏

2.1 收藏图片 / 2.2 取消收藏 / 2.3 收藏列表

界面要点:盲盒或捏脸结果图右上角的「心形」按钮;「收藏」标签页展示收藏列表。

阶段三 · 人设

3.1 人设模板(11种,多语言)

界面要点:人设编辑页的「模板」选择,含角色设定/沟通风格/开场白参考。

3.2 AI 润色人设

界面要点:用户写完人设后点「AI润色」,润色结果覆盖输入框;失败不阻断创建。

阶段四 · 正式创建

4.1 创建虚拟人

界面要点:最后一步点「创建」。需要选中的形象 ImageId + 昵称(12字内)+ 人设。服务端会严格使用当前用户设置的语言生成 Introduction:中文、日文、泰文等按字符计数,其他语言按单词计数,必须为25-35;文案要求撩人、有吸引力、若即若离但不粗俗露骨。同时生成4-6个只描述性格/情感气质的 PersonalityTags(例如“母性”“温柔”,不使用胸部、身材等外貌标签)。创建后自动回读「我的虚拟人」验证入库。

4.2 重新生成当前用户已有虚拟人简介(仅 Debug)

按当前用户设置的语言,将该用户全部未删除虚拟人的简介重新生成并严格校验为25-35字符/单词。只更新 Introduction;单条失败保留旧值;Release构建不包含此接口。

阶段五 · 自定义虚拟人聊天验收

5.0 测试解锁无限畅聊(模拟已支付)

仅供测试使用:为当前 OAID 写入 unlock_all_partner_chat_count 测试权益,使其与所有自定义虚拟人聊天时不再受100轮限制。该操作会真实写入测试权益记录。

5.0A 单角色 / 全角色付费接口

单角色权益永久绑定当前 PartnerId;两档商品只供聊天页调用,不进入通用支付页。创建订单只写待支付记录,不会直接解锁;“测试解锁单角色”才会模拟成功支付并真实写入权益。

5.1 准备本轮聊天 Prompt(服务端返回 postData)

界面要点:自定义虚拟人聊天不由服务端直接生成回答。服务端只校验登录/归属/轮数,创建 Pending 记录,并返回 Android 直连大模型所需的 postData。

5.2 保存 Android 直连大模型后的完整回答

界面要点:这里用手动输入模拟 Android 调大模型得到的回答。保存后应只返回文本状态,IsShow=false,图片/视频字段为空。

5.3 全部聊天历史 / 5.4 分页历史 / 5.5 删除单条聊天记录

界面要点:进入聊天页可用“全部历史”一次性拉取并按时间正序渲染;历史只展示未删除的已回答记录;删除是逻辑删除,只影响历史展示,不恢复免费聊天额度。

阶段六 · 管理与删除

6.1 我的虚拟人 / 6.2 详情 / 6.3 生成图片

界面要点:首页「我的虚拟人」封面和详情页顶部大图都必须使用 ImageUrl 原始形象图,不能使用可单独修改的 HeadImg 头像;详情页展示 PersonalityTags 性格标签、按用户语言生成并严格为25-35字符/单词的 Introduction 简介,以及「生成图片」分类。AppearanceTags 仅为兼容旧客户端保留。

6.4 修改头像 / 6.5 修改背景

界面要点:SetPartnerHeadImg直接上传Android相册照片;操作后自动回读详情验证。

6.6 清除记忆 / 6.7 删除虚拟人

界面要点:详情页「清除记忆」(保留资料)与「删除」(逻辑删除,列表消失)。删除后自动回读列表验证。
右侧日志区:点击左侧任意按钮后,这里会显示接口调用详情