scenario-mai-image

Scenario MAI Image

概览

Scenario 上的 Microsoft 图像系列 MAI Image 2.5 分为生成型号（2.5、2.5 Pro）和指令编辑型号（2.5 Edit、2.5 Pro Edit）。该系列的特色是文字排版：图像中的标题、标签和标语清晰易读，并按提示词中的位置呈现；适合制作包含真实文案的海报、包装、封面和主视觉素材。使用 search 发现各型号，并将 model_schema_get 视为接口契约：四款型号几乎所有字段都相同，只有承载源图像的字段不同。

连接方式和核心工作流程：请参阅本仓库中的 scenario 技能；与模型无关的图像工作（尺寸系列、蒙版、放大）：请参阅 scenario-image 技能。如果你可用的技能中缺少此处提到的同系列技能，请让用户安装它 （npx skills add scenario-labs/skills --skill <name>）；若在无人值守的情况下继续操作，请依据工具架构执行，并指出这一缺失。

快速参考

编写时（名称取自实时架构）：

型号	功能	源输入	比例
2.5	txt2img	无	11 种，含 21:9
2.5 Pro	txt2img	无	8 种
2.5 Edit	img2img	referenceImages，包含一个元素的数组	8 种
2.5 Pro Edit	img2img	image，单个文件	8 种

四款型号都支持 prompt（2.5 和 Edit 为 4096 个字符，Pro 系列为 5000 个字符）、aspectRatio（默认值为 auto 的枚举）和 numOutputs（1 至 4，每增加一张图像都会增加费用）。不存在宽度、高度、种子、负面提示词或蒙版字段：aspectRatio 是唯一的尺寸控制项；编辑时则通过在文字描述中点名元素来指定目标。生成型号会根据提示词选择 auto 比例；编辑型号则会匹配源图像，因此除非目的是重新构图，否则请保留此设置。

文字排版是关键

请使用完整句子，而非标签列表：该系列会大致按主体、构图、材质、光线和氛围的顺序进行推理。将图像中要呈现的准确文案放在引号内，以确保原样渲染，并为每个文本块说明其用途、样式和位置（“将标题 'GAME DAY' 以粗体窄体字放在上方三分之一区域”）。未加引号或含糊的文案可能会被改写或弄乱；许多小文本块也会相互干扰，因此请将它们合并。编写时，文字渲染针对英文进行了调优，输出尺寸接近 1K，因此请为印刷或主视觉用途规划后续放大。引导方式仅支持正向提示：使用 numOutputs 2 至 4 进行探索，并通过改写句子来完善结果，而不要反复寻找种子。

编辑：先保留，再做一处修改

两款编辑型号都接受一张源图像和一条普通指令，但字段不同：Edit 要求 referenceImages 数组中恰好包含一个资源 ID；Pro Edit 则要求 image 为单个文件。在两者之间移植参数块会导致运行失败，因此切换型号时请重新读取架构。提示词的结构应先说明必须保持不变的内容，再说明一处修改，并点明准确的元素及其确切的新状态；替换文案需放在引号内（“将标牌改为 'OPEN 24/7'，字体和颜色保持不变”）。若要进行多处修改，请分多次编辑；多轮编辑能很好地保持主体身份一致。这两个型号共用一个公开的图像编辑竞技场条目（编写时排名前 3），而 Pro Edit 的单个资源费用约为 Edit 的四倍，因此请对两者都运行 dry_run，并从 Edit 开始。

示例：先制作宣传海报，再替换文案

1. 使用 target="models"、query="mai image"、public=true 执行 search。记下生成和编辑结果，例如 model_microsoft-mai-image-2-5-pro 和 model_microsoft-mai-image-2-5-edit（撰写时的实时结果；每次会话都应重新搜索）。
2. 对生成模型执行 model_schema_get：查看比例列表、提示词长度上限和默认值。
3. 使用 dry_run=true 执行 model_run，参数为 parameters={"prompt": "A photorealistic poster of a climber on a granite wall at dawn, warm rim light, the headline 'ASCEND' in tall condensed sans-serif across the top, a small tagline 'Hold your line' lower left, editorial sports aesthetic.", "aspectRatio": "2:3", "numOutputs": 4}。 numOutputs 会影响成本，因此更改后请重新估算。
4. 使用 wait=false 重复执行，然后通过返回的任务 ID 调用 jobs_wait；超时时使用 pending_job_ids 再次调用，切勿再次执行 model_run。
5. 对四个输出执行 asset_display，并保留一个资源 ID。
6. 对编辑模型执行 model_schema_get，然后使用 parameters={"referenceImages": ["asset_x"], "prompt": "Keep the climber, lighting, and layout unchanged. Change only the headline to 'ASCEND HIGHER', same font, color, and placement."} 执行 model_run； 接着调用 jobs_wait，然后执行 asset_display。

常见错误

• 把一个编辑模型的源字段用于另一个模型：referenceImages（恰好包含一个元素的数组）和 image（单个文件）是各模型专属的字段形式。
• 图片文案不加引号：只有加引号的文本才会原样呈现。
• 在一条指令中堆叠多项编辑：每次只做一项更改，然后串联执行。
• 发送像素尺寸或模型不支持的比例：aspectRatio 是枚举值，且各模型的支持列表不同 （撰写时，一个模型支持 21:9、5:4 和 4:5）。
• 为了得到像素完全相同的结果而重新运行：没有种子值；保留效果最佳的资源并在此基础上继续编辑。
• 将 1K 输出用于印刷：请在后续流程中放大（参见 scenario-image 技能）。