目录
🎨 AI Image Generator—在 Scratch 中创建图像 #
AI Image Generator 扩展把强大的 AI 图像生成功能直接带进 Scratch。
只需输入简单的文字描述，就能使用以下引擎创建自定义角色和背景：
-
- OpenAI GPT 图像模型
- Google Gemini
- Stability AI
无需绘画技能 ✨
🌟 概述 #
- 文字生成图像： 描述你想要的画面，AI 就会立即生成。
- 多种 AI 引擎： OpenAI GPT 图像模型、Google Gemini、Stability AI。
- 13 种艺术风格： 卡通、像素、3D、水彩、动漫、奇幻等。
- 角色和背景： 生成角色造型或完整的舞台背景。
- 类型引导： 选择造型类型（角色/物品）或背景类型（户外/室内/抽象/太空/水下），引导生成结果。
- 背景控制： 可以自动保留或移除造型的背景。
- 适合儿童： 先在本地检查内容；如果有 OpenAI 密钥，还会使用 OpenAI 内容审核。内容审核端点本身免费；如果该端点被阻止，扩展会改用一个通常费用很低的小型分类器请求。
- 灵活的费用选择： 根据所用引擎，可以使用免费套餐、赠送额度或付费服务。
安全检查的工作原理： 提示词会先在本地检查，确认内容适合儿童。如果使用 OpenAI 且已设置密钥，扩展还会将提示词发送到 OpenAI 进行内容审核。内容审核端点免费；如果浏览器无法连接该端点，扩展会改用一个通常费用很低的小型分类器请求。
✨ 主要特点 #
- 支持 OpenAI GPT 图像模型、Google Gemini/Imagen 和 Stability AI 图像模型。
- 内置针对不同用途选择的默认模型；使用 update model list 可发现其他模型、新模型或别名模型。
- 预设 13 种适合 Scratch 项目的艺术风格。
- 提供造型和背景类型预设来引导提示词（角色/物品、户外/室内/抽象/太空/水下）。
- 智能移除背景，为角色造型生成透明背景。
- 自动调整图像大小，以适合角色造型和舞台背景。
- 按顺序命名（ai-costume1、ai-backdrop1、……）。
- 内置安全审核，让提示词适合儿童。
- 优化提示词，帮助获得更好的生成结果。
- 每个引擎分别保存 API Key。
🚀 如何使用 #
- 前往： pishi.ai/play
- 打开“扩展”面板。
- 选择： AI 图像生成器
- 从以下任一支持的平台获取 API Key：
选项 1：OpenAI（GPT 图像模型）
- OpenAI API Keys
- 创建一个新的 API Key（sk-proj-…).
- 可能需要提供账单信息。
选项 2：Google Gemini
- Google AI Studio
- 使用 Google 账号创建 API Key（AIza…).
- 许多地区提供免费套餐。
提示： 若要通过免费套餐使用图像生成 API，需要设置 Cloud Billing（设置后可获得免费使用额度）。
选项 3：Stability AI（推荐用于获取免费额度）
- Stability AI API Keys
- 创建免费账号。
- 🎁 新账号可获得免费的图像生成额度。
- 生成 API Key（sk-…），即可立即开始使用。
为 [ENGINE] 设置 api 密钥
粘贴密钥，开始生成图像。
🧱 积木和函数 #
🪄 生成角色造型 #
使用 [MODEL] 生成 [PROMPT|text] 的造型
生成一张 AI 图像，并将其添加为新的角色造型。
图像会调整为适合 Scratch 角色的大小，也可以选择将背景变为透明。
- PROMPT：描述你想生成的内容（例如“可爱的机器人”“像素风格的宇宙飞船”）。
- MODEL：选择要使用的 AI 图像引擎和模型。例如：
[openai] gpt-image-1, [gemini] gemini-2.5-flash-image, [stability] stable-image-core.
- 如需为之后生成的造型选择移除或保留背景，请使用： 造型生成后 [BG_MODE] 背景
- 造型会添加到积木开始运行时所选的角色中。
- 如果没有可用的角色，扩展会自动创建一个新角色。
- 新造型会立即被选中。
例如：
使用 [{openai} gpt-image-1] 生成 [Friendly dragon with small wings|text] 的造型
🧩 造型类型 #
将造型类型设为 [COSTUME_TYPE]
设置角色造型的类型。
- COSTUME_TYPE: character 或 object
- 选择 character 可生成位于画面中央的角色（通常是全身）。
- 选择 object 可生成构图简洁、与背景分离的物品或道具。
提示： 此设置会一直生效，直到你更改它。
例如：
将造型类型设为 [object]
使用 [{openai} gpt-image-1] 生成 [Hercule Poirot Mustache|text] 的造型
✂️ 移除背景（造型） #
造型生成后 [BG_MODE] 背景
控制之后生成的造型是否移除背景。
- BG_MODE: remove （让背景透明）， keep （保留背景）。
提示： 此设置只影响造型，不影响舞台背景。
🌄 生成背景 #
使用 [MODEL] 生成 [PROMPT|text] 的背景
生成一张 AI 图像，并将其添加为新的舞台背景。
图像会调整为适合 Scratch 舞台的大小。
- PROMPT：描述场景或环境。
- MODEL：选择要使用的 AI 图像引擎和模型。
- 背景会调整为 480×360。
- 背景图像的原有背景始终会保留。
- 如需引导场景风格，请使用： 将背景类型设为 [BACKDROP_TYPE]
例如：
使用 [{gemini} gemini-2.5-flash-image] 生成 [A Room in Pink Theme|text] 的背景
🏷️ 背景类型 #
将背景类型设为 [BACKDROP_TYPE]
设置生成舞台背景时使用的场景类别。
- BACKDROP_TYPE: outdoor, indoor, abstract, space, or underwater.
提示： 此设置会一直生效，直到你更改它。
例如：
将背景类型设为 [indoor]
使用 [{gemini} gemini-2.5-flash-image] 生成 A Place in Green Theme and Pixel style|text] 的背景
使用 [{stability} stable-diffusion-xl-1024-v1-0] 生成 [A Smiling Robot in Pixel style|text] 的造型
🎭 自定义风格 #
将图像样式设为 [STYLE]
设置之后所有图像生成使用的视觉艺术风格。
- STYLE：选择一种预设艺术风格。
- cartoon（卡通）、simple（简约）、pixel（像素）、3d（3D）、watercolor（水彩）、sketch（素描）
- comic（漫画）、anime（动漫）、origami（折纸）、clay（黏土）、voxel（体素）、sticker（贴纸）、fantasy（奇幻）
提示： 所选风格会一直生效，直到你更改它。
例如：
将图像样式设为 [origami]
使用 [{gemini} gemini-3-pro-image-preview] 生成 [An Empty Sunny Beach|text] 的造型
使用 [{stability} stable-image-core ] 生成 [A Funny Frog with its Tongue out|text] 的造型
🔑 API Key 管理 #
为 [ENGINE] 设置 api 密钥
保存所选 AI 引擎的 API Key。
- ENGINE：可选择： openai, gemini, stability.
- 每个引擎的密钥会分别保存。
- 密钥只会保存在当前浏览器会话中。
- 关闭标签页后，密钥就会被清除。
提示： Stability AI 在注册时提供免费额度，适合作为入门选择。
🤖 模型管理 #
更新 [ENGINE] 模型列表
从所选平台获取最新的可用图像模型。
- ENGINE：选择要更新模型列表的 AI 平台。
- 需要有效的 API Key。
- 运行此积木可以向菜单添加新模型，包括新发布的模型、别名，以及默认模型的较早版本。
- 例如： nano-banana-pro-preview : 其实只是预览版/别名,正式版本是 gemini-3-pro-image-preview.
默认模型列表（更新前）：
- OpenAI: gpt-image-1, gpt-image-1.5, gpt-image-2
- Google Gemini: gemini-2.5-flash-image, gemini-3-pro-image-preview, imagen-4.0-generate-001, imagen-4.0-fast-generate-001
- Stability AI: stable-diffusion-xl-1024-v1-0, stable-image-core
📊 状态与错误 #
上次生成的 [ASSET_TYPE] 名称
返回最近生成的素材名称。
- ASSET_TYPE: costume 或 backdrop
上一次图像生成错误
返回最近一次图像生成的错误信息；如果成功，则返回空值。
- 可用于调试，或向用户显示易于理解的提示。
🎓 教育用途 #
- 了解 AI 如何生成图像：
学生探索将文字转换为图像的过程，并了解现代多模态模型如何工作。 - 练习比较 AI 引擎和艺术风格：
尝试不同模型（OpenAI GPT 图像模型、Stability 等），看看即使用相同的提示词，它们也会生成怎样不同的结果。 - 快速创建游戏素材：
无需绘画技能即可制作角色、背景、道具和图标，让 Scratch 项目的创作更容易。 - 通过实验学习编写提示词：
学生可以观察措辞如何影响最终图像，并学习如何让描述更清晰、控制风格和发挥创意。 - 让故事与动画项目更丰富：
快速生成互动故事、漫画和动画所需的场景与角色。 - 练习安全、负责任地使用 AI：
讨论为什么某些提示词受到限制、内容审核如何保护用户，以及在创作工具中负责任地使用 AI 的重要性。 - 鼓励个人创意和自主创作：
学生可以按照自己的想法生成专属设计，让学习更有趣，也更能表达自我。 - 帮助教师制作视觉材料：
教师可以直接在 pishi.ai 项目中生成示意图、教具和简单插画。
🔧 提示和故障排除 #
🧠 如何选择合适的生成引擎 #
最适合你的引擎取决于你更看重图像质量、速度、费用还是控制能力。下面是一个简短的对比，帮助你为课堂或项目选择引擎。
- 整体画质与理解能力最佳： OpenAI GPT 图像模型
- 生成速度最快且图像质量出色： Google Gemini（Flash / 快速版 Imagen）
- 自定义选项和艺术控制能力最强： Stability AI (SDXL / stable-image-core / SD3)
- 最适合从免费额度开始： Stability AI（注册时赠送免费额度）
快速选择提示： 在课堂上使用时，可以先选择 Stability 来节省费用并进行实验。制作最终的高质量素材时，可以使用 OpenAI GPT 图像模型。需要快速获得反馈（例如草图或缩略图）时，可以试试 Gemini Flash 或速度更快的 Imagen 型号。
注意：
- 使用简洁的风格，更容易得到干净的去背景效果。
- 将提示词写得具体一些，获得更好的结果。
- 生成多个造型，为角色制作动画。
- 留意使用量，避免产生意外费用。
🔒 隐私与安全 #
- 生成图像需要网络连接。
- 提示词会经过检查，确保内容适合儿童。
- 图像保存在你的 Scratch 项目本地。
- 绝不要公开分享 API Key。
- 儿童使用 AI 工具时，请有成年人陪同指导。
💰 费用与使用量 #
OpenAI GPT 图像模型： 按图像付费
Google Gemini: 免费套餐（需要设置 Cloud Billing）和付费选项
Stability AI: 注册时赠送免费额度，之后按额度计费
- 将免费套餐和赠送额度用于教学。
- 测试时先使用费用较低的模型。
- 清楚地描述提示词，减少重新生成的次数。
🔗 相关扩展 #
- 💬 ChatGPT—生成更好的提示词
- 🎤 Speech Recognition—用语音输入提示词
- 🖊️ Text to Speech—为图像配音
- 📝 Translate—制作多语言提示词
