游戏内 AI：为玩家生成文本、图片、音乐和 3D

玩家看到什么

• AI 工作室，按类型列出你开放的所有功能：文本、图片、语音、音乐、视频、3D。
• 描述和价格：玩家描述想要的内容，并用游戏资源支付，或免费。
• 服务器任务的结果：文本、图片、音频和视频播放器、3D 的下载链接。
• “我的作品”：玩家的生成历史。

如何运作

• 功能由你设置：生成什么、隐藏的提示词以及限制；玩家永远看不到提示词和模型。
• 生成费用先从套餐的 AI 积分中扣除，超出部分从你的 iDos Games 账号 Aspis 中扣除；玩家以游戏资源或 Aspis 支付的价格由你决定。Aspis 仅在生成完成时扣除：生成失败不向玩家收费。
• 标记为隐藏的功能供游戏自己的代码使用（NPC 台词等），不会在工作室中显示；体素沙盒就是这样生成世界的。

开发者须知

游戏内 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 会跟踪服务器任务。
• 对现成模型的 3D 步骤接收 SourceGenerationId：玩家在本游戏中自己已完成的 3D 生成的 id。他人的生成会被拒绝。

每个字段都在技能 ai-generation-system 中有说明，由 SDK 的 MCP 服务器提供。