SuperAPI AI 工具集

text-to-avatar

设计与创作

查看项目

更新于 10-16 02:31

技能介绍

用途:根据自然语言描述或1至4张参考图片,生成带纹理的高质量3D虚拟形象(GLB格式),适用于需要角色、人物或模型资产的场景。

主要能力:支持文本生成与图像到3D重建两种模式;可请求PBR纹理(默认开启);支持seed以复现结果;输出glbUrl及源提示、所选模型版本、Replicate预测ID和耗时等元数据。

使用方式:通过three.ws MCP服务器(@three-ws/mcp-server)调用text_to_avatar。prompt与images二选一,prompt不超过1000字符,images为1至4个公开http(s)图片URL。该工具为付费通道,每次调用0.15 USDC,经x402自动结算,需在MCP传输层配置已注资钱包(MCP_SVM_PAYMENT_ADDRESS);若未附带支付载荷,会返回PaymentRequired结构化结果说明应付金额,此时应告知价格与充值方式,不要盲目重试。后端为Replicate,默认Hunyuan-3D 3.1,同步轮询直至生成GLB或超时。

适用场景:需要静态虚拟形象且追求较好纹理效果时使用;若只需免费纯文本草稿可用forge-3d(forge_free);若需一次调用即生成并绑定骨骼、可直接动画的形象,应使用auto-rig(forge_avatar)。

限制:结果为静态网格,绑定骨骼需另用rig_mesh,或改用forge_avatar一步完成。平台仅用$THREE做支付记账,x402结算本身使用USDC。生成后可用avatar服务器的inline-render/embed-iframe工具渲染或分享,也可打开https://three.ws/viewer?src=<glbUrl>查看。其他细节暂未提供。