ai-studio-image

支持材料可用性

此目录副本包含下方的内联指导，但不包含以下支持路径。这些是外部前置条件，并非随附文件：

• <support-root>/references/api-reference.md

使用依赖这些路径的步骤前，请索取原始支持材料或现有安装。此目录未提供经过验证的下载来源。请根据该安装解析各路径，检查其内容，并核实适用的许可证和执行前提。所需文件不存在时，不要运行命令，也不要声称已遵循所引用的流程。不要伪造缺失的脚本，也不要将名称相同但无关的文件视为等效文件。此处已完整说明的独立步骤，可在用户授权范围内继续；任何依赖材料的步骤都应报告为不可用。

AI Studio Image — 拟真人像图像专家

概述

通过 Google AI Studio（Gemini）生成拟真人像图像。生成具有自然光照和细微瑕疵、呈现网红风格或教育风格的逼真照片。

何时使用此技能

• 用户提到“生成图像”或相关主题时
• 用户提到“生成照片”或相关主题时
• 用户提到“创建图像”或相关主题时
• 用户提到“逼真照片”或相关主题时
• 用户提到“拟真人像图像”或相关主题时
• 用户提到“网红照片”或相关主题时

何时不要使用此技能

• 任务与 AI Studio Image 无关
• 更简单、更具体的工具可以处理该请求
• 用户需要的是一般性帮助，无需领域专业知识

工作原理

AI 图像与真实照片的区别在于那些难以察觉的细节： 手机传感器产生的轻微颗粒感、不完美的光线、略微偏离中心的构图，以及小型镜头特有的景深。 此技能会在每次生成中系统性地融入这些特质。

AI Studio Image — 拟真人像图像专家

一项通过 Google AI Studio 生成图像的技能，可将任何提示词转换成看起来真实自然的照片。每张生成的图像都像是由真人用手机拍摄的，而非由 AI 制作。

1. 配置 API Key

用户需要 Google AI Studio 的 API key：

• 访问 https://aistudio.google.com/apikey
• 创建或复制 API key
• 将其配置为环境变量：

## Windows

set GEMINI_API_KEY=sua-api-key-aqui

## Linux/Mac

export GEMINI_API_KEY=sua-api-key-aqui

或者在 <skill-root>/ 中创建 .env 文件：

GEMINI_API_KEY=sua-api-key-aqui

2. 安装依赖项

pip install -r <skill-root>/scripts\requirements.txt

3. 生成第一张图像

python <skill-root>/scripts\generate.py --prompt "mulher jovem tomando cafe em cafeteria" --mode influencer --format square

主要工作流

用户要求生成图像时，请按以下流程操作：

步骤 1：识别模式

根据上下文询问或推断：

模式	使用场景	特点
influencer	社交媒体帖子、生活方式、个人品牌打造	风格吸引人但自然，色彩鲜明但不过度饱和，构图引人注目
educacional	课程材料、教程、演示文稿、信息图	画面简洁、专业，聚焦内容，元素清晰易读

如果用户未指定，社交媒体内容默认使用 influencer，与教学或演示相关的内容使用 educacional。

步骤 2：识别格式

格式	宽高比	理想用途
square	1:1	Instagram、Facebook 信息流，个人主页
portrait	3:4	Instagram 竖版帖子、Pinterest
landscape	16:9	YouTube 缩略图、横幅、桌面端
stories	9:16	Instagram/Facebook Stories、TikTok、Reels

如果未指定，请根据上下文推断（stories → 9:16，信息流 → 1:1 等）。

步骤 3：转换提示词

这是最重要的一步。 切勿直接将用户的提示词发送到 API。 务必先通过人性化引擎处理：

python <skill-root>/scripts\prompt_engine.py --prompt "prompt do usuario" --mode influencer

人性化引擎会增加真实感：

层 1 — 设备和技术：

• 使用智能手机拍摄（iPhone/Samsung Galaxy）
• 手机镜头呈现自然景深
• 不使用闪光灯 — 仅使用环境光
• 轻微的传感器噪点（低光下使用高 ISO）

层 2 — 自然光照：

• 间接阳光 / 黄金时刻 / 窗边光
• 柔和自然的阴影
• 不使用影棚灯光
• 表面上的自然反光

层 3 — 人为瑕疵：

• 构图略有瑕疵（并非数学意义上的居中）
• 自然的选择性对焦（背景中有些物体略微失焦）
• 手部轻微抖动（并非绝对清晰）
• 真实环境中的随机元素

层 4 — 真实感：

• 自然的面部表情（不是影棚摆拍）
• 日常服装和场景
• 真实的皮肤纹理（毛孔、细微痕迹 — 不要瓷质肌肤）
• 符合真实情况的身体比例

层 5 — 环境背景：

• 真实场景（不是通用图库背景）
• 环境中的日常物品
• 与场景一致的光照
• 时间与活动相符

步骤 4：生成图像

python <skill-root>/scripts\generate.py \
  --prompt "prompt humanizado gerado no passo anterior" \
  --mode influencer \
  --format square \
  --model gemini-2-flash-exp \
  --output <skill-root>/data\outputs\

可用模型（按推荐顺序排列）：

模型	速度	质量	费用	理想用途
gemini-2-flash-exp	快	高	费用待确认	历史快照；请确认可用性
imagen-4	中	高	$0.03/img	高质量（需要 --force-paid）
imagen-4-ultra	慢	最高	$0.06/img	印刷、2K（需要 --force-paid）
imagen-4-fast	快	良好	$0.02/img	大批量生成（需要 --force-paid）
gemini-flash-image	快	高	$0.039/img	图像编辑（需要 --force-paid）
gemini-pro-image	中	最高+4K	$0.134/img	参考图、4K（需要 --force-paid）

步骤 5：展示并迭代

向用户展示结果。如需调整：

• 调亮：调整光照
• 重新构图：更改构图
• 更自然 / 不那么自然：调整瑕疵程度
• 更改场景：更改环境

预设模板

对于常见场景，请使用现成模板。执行：

python <skill-root>/scripts\templates.py --list

可用模板：

网红模式

模板	描述
cafe-lifestyle	人在咖啡馆 / 餐厅中，手持饮品或食物
outdoor-adventure	户外活动、自然风光、旅行
workspace-minimal	精致的工作桌、家庭办公室
fitness-natural	以自然风格呈现运动 / 健康生活
food-flat-lay	俯拍食物，随性的平铺构图
urban-street	城市场景、街头风格
golden-hour-portrait	日落时分金色光线下的肖像
mirror-selfie	镜子自拍，自然随意
product-in-use	人物自然地使用产品
behind-scenes	幕后花絮、制作过程、真实日常

教育模式

模板	描述
tutorial-step	人物演示教程步骤
whiteboard-explain	人物在白板 / 黑板前讲解
hands-on-demo	双手进行实操演示
before-after	前后对比
tool-showcase	正在使用的工具 / 软件
classroom-natural	课堂 / 工作坊环境
infographic-human	人物指向数据 / 图表
interview-setup	自然的访谈 / 播客布景
screen-recording-human	人物拿着笔记本电脑展示屏幕
team-collaboration	团队自然地协同工作

使用模板：

python <skill-root>/scripts\generate.py \
  --template cafe-lifestyle \
  --custom "mulher ruiva, 30 anos, lendo livro" \
  --format square

拟真程度

控制注入多少“不完美”：

级别	效果
ultra	极致真实——看起来像 100% 的手机照片
natural（默认）	在质量与真实感之间取得完美平衡
polished	更干净，依然自然，但美感上更精致
editorial	杂志风格，自然且经过制作

python <skill-root>/scripts\generate.py \
  --prompt "..." --humanization natural

一天中的时段

光线会发生显著变化：

选项	描述
morning	柔和的晨光，冷暖色调
golden-hour	日落／日出，金色调
midday	正午的强光，阴影明显
overcast	阴天，光线均匀柔和
night	人工照明，暖色调
indoor	室内光线，混合光源

批量生成

生成多个变体：

python <skill-root>/scripts\generate.py \
  --prompt "..." --variations 4 --format square

Instagram 技能

生成图像，并且仅在获得明确发布授权后发布：

1. 使用 ai-studio-image 生成照片
2. 使用 instagram 技能，配上优化后的说明文字进行发布

Canva 集成

生成的图像可以发送到 Canva，以添加文字／品牌元素。

故障排除

问题	解决方案
GEMINI_API_KEY not found	配置环境变量或创建 .env
quota exceeded	等待速率限制重置，或升级套餐
image blocked	调整提示词——其中可能包含受限内容
low quality output	将拟真程度调高至 ultra，或尝试其他模型

参考资料

如需详细指南，请参阅：

• references/setup-guide.md — 完整安装与配置指南
• references/prompt-engineering.md — 生成拟真图像的高级提示词技巧
• references/api-reference.md — Google AI Studio API 文档

最佳实践

• 提供清晰、具体的项目背景和需求
• 在将任何建议应用于生产代码前，先进行审核
• 与其他互补技能结合使用，以进行全面分析

常见陷阱

• 将此技能用于其专业领域之外的任务
• 未了解自身具体情况就应用建议
• 未提供足够的项目背景，导致分析不准确

相关技能

• comfyui-gateway - 用于增强分析的互补技能
• image-studio - 用于增强分析的互补技能
• stability-ai - 用于增强分析的互补技能

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为可替代特定环境验证、测试或专家审查的内容。
• 如果缺少必要输入、权限、安全边界或成功标准，请停止并请求澄清。

快照限制与授权

文中提及的模型、价格和功能信息均为历史信息，未经服务验证。使用前请查阅 https://ai.google.dev/gemini-api/docs/image-generation 和价格表。每次调用都必须使用 --force-paid 确认费用；不保证任何模型免费。每日计数器仅在本地运行，是近似值且不具备原子性；它不会限制账户，也不会涵盖失败／重试或其他目录产生的成本。

请勿将个人图像、机密提示词或未经授权的参考资料发送至外部进行处理。提示词和元数据会保存在本地：请保护输出文件夹。生成结果为合成内容；真实感不代表内容忠实、文字正确或具有摄影来源。CLI 并未实现文中所述的多轮对话、思考和 grounding 功能。请勿自动发布。请使用虚拟环境，并以真实路径替代 ；保护 .env，并将其从 Git 中排除。避免重复对提示词进行拟真化处理：generate.py 已应用该引擎。