本技能面向 Stability AI 图像相关工作流的编排，目标是在写提示词之前先做路由决策：托管平台 API 用于受管的 Stable Image 生成、编辑、控制、放大、审核与来源签名；开放权重仅在需要本地数据控制、自定义推理、微调或部署控制且能承担许可义务时使用。不要暗示 Stable Image Core 或全部微服务都是可下载权重，可下载的 SD3.5 检查点与托管服务目录只是部分重叠。
主要能力按操作划分。生成：Ultra（POST /v2beta/stable-image/generate/ultra，可选 init 图）、Core（/generate/core，低成本快速迭代）、SD3.5 套件（/generate/sd3，可选 sd3.5-large、sd3.5-large-turbo、sd3.5-medium、sd3.5-flash）。编辑：擦除 /edit/erase、修复 /edit/inpaint、外绘 /edit/outpaint、搜索替换 /edit/search-and-replace、搜索换色 /edit/search-and-recolor、移除背景 /edit/remove-background、替换背景并重打光 /edit/replace-background-and-relight。控制：草图 /control/sketch、结构 /control/structure、风格指南 /control/style、风格迁移 /control/style-transfer。放大：快速 /upscale/fast、保守 /upscale/conservative、创意 /upscale/creative。
用法要点：基址 https://api.stability.ai，请求头 Authorization: Bearer <STABILITY_API_KEY>、Accept: image/*；所有图像 POST 体为 multipart/form-data，由 HTTP 库设置 Content-Type 与 boundary。二进制响应读取 content-type、x-request-id、finish-reason、seed 头；JSON 响应含 image（base64）、seed、finish_reason。finish_reason 为 SUCCESS 或 CONTENT_FILTERED，后者即使 HTTP 200 也应按 QA 失败处理。Creative Upscale 与 Replace Background and Relight 为异步：先 POST 取得 64 位 id，再以同一密钥轮询 GET /v2beta/results/{id}，轮询间隔至少 10 秒，404 表示 id 错误、属其他密钥或已过期；结果仅保留 24 小时，需立即下载。API 文档未提供幂等键，因此不要自动重试不确定的付费 POST。
限制：多数编辑/控制输入要求每边至少 64 像素、总像素 4,096–9,437,184、宽高比 1:2.5–2.5:1；Remove Background 总像素上限 4,194,304；请求体上限 10 MiB；输出格式 png/jpeg/webp，Remove Background 仅 png 或 webp；seed 范围 0–4,294,967,294，0 或省略表示随机。部分端点行为与定价、尺寸上限存在文档冲突（如 Flash 枚举、Fast Upscaler 最大 MP），应在目标账户先做低成本验证再批量，不要以营销文案作为合同上限。使用前确认权利、同意、隐私与当前可接受使用政策；本技能中易变的 API 事实核验于 2026-07-09，投入花费或长期集成前应重新核对 API 参考、价格与发布说明。