2025 年 9 月 12 日,Roblox 官方发布了照片转头像(Photo-to-Avatar)API 的早期预览版(Alpha),这是基于生成式 AI 技术开发的新功能,旨在帮助开发者为用户打造独特体验,目前可支持将用户自拍转化为可在平台内使用的 Roblox 头像,并能结合现有 API 进行编辑、付费与保存操作,现阶段主要用于开发者构建概念验证项目,测试相关生成能力并探索最佳集成方式,未来官方将持续优化该 API,以提升头像对照片的还原度,并增加更多自定义和风格化选项。
它的工作原理
照片转头像 API 的使用需多步骤完成,具体流程如下:
- 请求头像生成会话:开发者需在服务器端调用
AvatarCreationService:RequestAvatarGenerationSessionAsync()
,为玩家请求一个AvatarGeneration
会话,该会话会为玩家提供一定数量的头像预览、生成次数以及生成时间限制。
- 提示用户自拍并生成 2D 预览:首先通过
AvatarCreationService:PromptSelectAvatarGenerationImageAsync()
提示用户拍摄自拍,获取fileId
字符串;接着在服务器端,将fileId
、SessionId
以及可选的文本提示一同传入AvatarCreationService:GenerateAvatar2DPreviewAsync()
,生成头像的 2D 预览,得到previewId
;最后将previewId
发送至客户端,调用AvatarCreationService:LoadAvatar2DPreviewAsync()
,以EditableImage
形式获取预览内容。

- 生成完整 3D 头像:当用户对 2D 预览满意后,在服务器端调用
AvatarCreationService:GenerateAvatarAsync()
,传入包含SessionId
和PreviewId
的字典,生成generationId
;随后使用AvatarCreationService:LoadGeneratedAvatarAsync()
方法,以HumanoidDescription
形式获取生成的 3D 头像,其网格和纹理分别以EditableMesh
和EditableImage
对象呈现,支持进一步编辑。
- 编辑并保存头像至库存:用户完成头像编辑后,可调用
AvatarCreationService:PromptCreateAvatarAsync()
方法发布头像,将其保存到个人库存中,以便在平台内跨场景使用。
为帮助开发者理解代码实现,官方还提供了相关场景文件(place file),开发者可直接查看实现细节,并以此为基础构建和测试自己的体验项目。
安全与规范
为确保功能推出过程中的安全性,该 API 有严格的使用限制和内容规范:
- 使用范围限制:仅支持实时拍摄的自拍照,且仅限 13 岁及以上用户使用。
- 内容审核机制:用户提交的图像需符合 Roblox 社区标准和使用条款,AI 模型经过训练,仅生成符合规范的头像,避免产生不当内容;官方还开展了大量违规内容测试,并开发了新工具,用于主动识别和处理潜在违规情况。
作为 Alpha 版本,该 API 存在诸多待改进的局限性:
- 平台可用性:目前仅支持 iOS 和 Android 系统,其他平台暂不兼容。
- 用户资格:仅对部分国家和地区的 13 岁及以上用户开放。
- 图像来源:仅支持实时拍摄自拍,暂不支持从相册上传图像。
- 输出质量:受光线、背景等多种因素影响,生成的头像与原始图像的相似度可能存在差异,整体质量有待提升。
- 风格单一:当前仅能生成具有写实风格的头像,缺乏多样化风格选择。
- 生成范围有限:仅生成头像的头部(可选包含头发)和身体,且身体类型仅基于头部照片生成,可能与用户实际身体类型存在差异;暂不支持生成服装和配饰。
未来,Roblox 计划对该 API 进行扩展,增加更多风格选项、扩大平台支持范围、丰富生成内容(如服装和配饰),此次 Alpha 版本的发布是实现这一目标的重要第一步,官方期待开发者反馈,并关注基于该 API 创建的各类体验项目。
常见问题
- 开发者收益:当用户在体验场景中购买生成的头像时,开发者可获得销售额的 70%,其中 30% 作为 “创作者” 收益,40% 作为体验场景开发者收益。
- 用户头像售卖权限:目前不允许用户在市场(Marketplace)上售卖生成的头像,在体验场景中创建的身体头像仅存入用户个人库存,不可在市场交易、转让或转售给其他用户。
- 开发者要求:与 UGC(用户生成内容)头像创作者的要求一致,开发者需完成身份验证(ID-verified)并开通 Premium 会员,才能使用发布相关 API;此外,开发者需购买与 UniverseID 和资产类型绑定的令牌(token),并支付发布费用,流程与头像创作者类似。
- 用户发布要求:用户在体验场景中创建头像时,无需完成身份验证或开通 Premium 会员。
- 头像审核失败退款政策:若头像违反 Roblox 社区标准,审核失败,用户无法获得退款;但与其他提交内容一样,若用户认为头像审核有误,可提交申诉,请求重新审核。
- 模型训练数据:AI 模型基于 Roblox 自行整理和开发的数据集进行训练,未使用任何 Roblox 创作者的数据。
- 数据集中潜在偏见的处理:Roblox 认识到 AI 算法和数据集可能存在或放大不公平偏见,消除模型中的偏见是其核心目标之一。为此,官方采用多样化数据集、结合多方面见解与反馈对 AI 进行微调,并通过大量违规内容测试及开发新工具,主动防范和处理潜在偏见与违规问题。
暂无评论内容