游戏内 AI 让玩家在你的游戏里创作：通过你向他们开放的功能，生成文本、图片、语音、音乐、视频和 3D 模型。 提示词和模型都留在服务器上；玩家只需描述想要什么，并支付你设定的游戏资源价格，或者免费。
玩家看到什么
- AI 工作室，按类型列出你开放的所有功能：文本、图片、语音、音乐、视频、3D。
- 描述和价格：玩家描述想要的内容，并用游戏资源支付，或免费。
- 服务器任务的结果：文本、图片、音频和视频播放器、3D 的下载链接。
- “我的作品”：玩家的生成历史。
AI 工作室
12 450
320
图片
文本
音乐
英雄肖像
“身穿金色铠甲的狐狸骑士，卡通风格”
生成 · 20
狐狸骑士已完成
战斗主题曲生成中…
1你向玩家开放的 AI 功能，按类型分：文本、图片、语音、音乐、视频、3D。
2玩家描述想要的内容，用游戏资源支付功能价格（或免费）。
3“我的作品”：结果来自服务器执行的任务。
如何运作
- 功能由你设置：生成什么、隐藏的提示词以及限制；玩家永远看不到提示词和模型。
- 生成费用从你的 iDos Games 账号积分中扣除；玩家以游戏资源支付的价格由你决定。
- 标记为隐藏的功能供游戏自己的代码使用（NPC 台词等），不会在工作室中显示；体素沙盒就是这样生成世界的。
步骤 01把系统加入项目
告诉 AI 编程助手：“让玩家可以生成英雄肖像”。它会安装 AI 工作室，或者从游戏自己的代码中调用该功能。
步骤 02在后台中设置
打开后台，选择你的项目，进入 实时运营 → v2 → 应用内 AI。
- 创建功能：类型（文本、图片、语音、音乐、视频、3D）、隐藏的提示词及其质量模式。
- 设置玩家需要支付的游戏资源价格，以及每位玩家的限制。
- 设置游戏的花费上限，避免热门游戏花掉比你计划更多的积分。
页面上的 AI 按钮会打开助手：描述你的需求，它会提出修改，你检查后点击保存。
步骤 03测试并发布
在应用的测试版中检查系统。设置通过单独的操作发送到正式应用，请看发布与链接。
开发者须知
游戏内 AI 通过 @idosgames/core 中的 client.ai 工作。
// 通过游戏的 'skin-gen' 功能，根据玩家的描述生成一张图片
const res = await client.ai.generateImage('skin-gen', { Prompt: text })
if (!res.ok) return showError(res.error) // 被拒绝：没有生成，也没有扣费
// 任务由服务器执行；等待结果
const done = await client.ai.waitForGeneration(res.data)- 请求被拒绝（达到限制、不可用）不会扣费：显示原因，并建议稍后再试。
- 不要自己循环等待：
waitForGeneration会跟踪服务器任务。
每个字段都在技能 ai-generation-system 中有说明，由 SDK 的 MCP 服务器提供。
常见问题
生成的费用由谁支付？
生成费用从你账号的积分中扣除；你可以为玩家设置以游戏资源计的价格。
玩家能看到我的提示词吗？
不能。提示词和模型都留在服务器上；玩家只能看到你开放的功能。