@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Fal.md

@@ -1,55 +1,55 @@
-# GPT Image 2.5 · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-10 |
-| 模型路由 | `openai/gpt-image-2.5/{flare,sunburst}/{text-to-image,edit}` |
-| 文档/价格 | 公开，无需登录；四份端点实时llms.txt已核对 |
-
-## 请求与计费
-
-`POST https://queue.fal.run/<路由>`，`Authorization: Key <key>`，JSON。
-Flare/Sunburst显式选择，无图文生图、有图edit；默认Flare、智能比例、1K、high、1张、auto背景。
-
-| 字段 | 类型 | 约束 |
-|---|---|---|
-| prompt | string，必填 | 生成/编辑说明 |
-| image_urls | string[]，编辑必填 | 最多16张；文生图不发送 |
-| mask_url | string，编辑可选 | 遮罩；复用应用内绘制/编辑和官方上传 |
-| image_size | object或枚举 | {width,height}，16倍数、边≤3840、比例≤3、面积655360–8294400；文生图API默认landscape_4_3，编辑auto |
-| quality | string | auto/low/medium/high/xhigh/max；API默认high |
-| background | string | auto/transparent/opaque；默认auto |
-| num_images | integer | 1–10，默认1（旧2为1–4） |
-| output_format | string | jpeg/png/webp，默认png；产品不展示、不请求 |
-| output_compression | integer | 0–100；仅jpeg/webp，产品不请求 |
-| sync_mode | boolean | 默认false；产品采用队列、不请求 |
-
-尺寸选项用合法像素明确提交；不把smart/auto直传。遮罩基于第一张参考图，通过共享派生媒体契约创建、继续编辑和源图变化失效。
-token基础价与2相同：文本输入$5/M、缓存$1.25/M；图片输入$8/M、缓存$2/M、输出$30/M。Fal端点页另写文本输出$10/M，但图像模型无文本输出。
-Fal公开实测1024方图low/medium/high约$0.0060/$0.0133/$0.0528（编辑单参考图约$0.0142/$0.0215/$0.0610）；不是固定每张价格。
-计价仅给输出参考估算，采用APIMart公开同型号尺寸/token参考表乘Fal输出单价，明确跨来源参考而非Fal报价；输入token另计，auto按max。不沿用2旧high=$0.211。
-
-## 队列契约
-
-| 事件/状态 | 前置 | 字段与空值 | 下一状态/输出 | 终态/副作用/复用 |
-|---|---|---|---|---|
-| 提交 | 未提交 | request_id非空，status_url/response_url/cancel_url由服务返回 | 保存ID和同源URL，pending | 独立HTTP |
-| IN_QUEUE | 提交后 | status必需；queue_position可选 | pending | 继续轮询 |
-| IN_PROGRESS | pending | status必需；logs可为空 | pending | 继续轮询 |
-| COMPLETED | pending | 状态完成仍需读取response_url | 读取images | 不把状态响应当图片 |
-| 结果 | COMPLETED后 | images数组，ImageFile.url必须有效 | completed/images | 停止轮询 |
-| 请求/任务错误 | 任意 | HTTP错误或错误响应 | 报错 | 停止等待 |
-
-重复处理中事件允许；官方未保证严格顺序。取消API为PUT cancel_url；本次沿用SDK现有本地取消，不新增远端取消动作。取消/超时释放本地等待，不承诺退费。空结果拒绝；复用既有Fal同源URL校验、轮询与取消测试。
-官方字面示例与字段表位于 `tests/fixtures/gpt-image-2.5/`；无付费真网证据。
-
-## 原始链接索引
-
-均公开无需登录：
-- [Flare文生图](https://fal.ai/models/openai/gpt-image-2.5/flare/text-to-image/llms.txt)
-- [Flare编辑](https://fal.ai/models/openai/gpt-image-2.5/flare/edit/llms.txt)
-- [Sunburst文生图](https://fal.ai/models/openai/gpt-image-2.5/sunburst/text-to-image/llms.txt)
-- [Sunburst编辑](https://fal.ai/models/openai/gpt-image-2.5/sunburst/edit/llms.txt)
-- [Fal实测价格表](https://fal.ai/gpt-image-2.5)
-- [队列协议](https://fal.ai/docs/documentation/model-apis/inference/queue)
-- [同型号尺寸与输出token参考表](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5/generation.md)
+# GPT Image 2.5 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 模型路由 | `openai/gpt-image-2.5/{flare,sunburst}/{text-to-image,edit}` |
+| 文档/价格 | 公开，无需登录；四份端点实时llms.txt已核对 |
+
+## 请求与计费
+
+`POST https://queue.fal.run/<路由>`，`Authorization: Key <key>`，JSON。
+Flare/Sunburst显式选择，无图文生图、有图edit；默认Flare、智能比例、1K、high、1张、auto背景。
+
+| 字段 | 类型 | 约束 |
+|---|---|---|
+| prompt | string，必填 | 生成/编辑说明 |
+| image_urls | string[]，编辑必填 | 最多16张；文生图不发送 |
+| mask_url | string，编辑可选 | 遮罩；复用应用内绘制/编辑和官方上传 |
+| image_size | object或枚举 | {width,height}，16倍数、边≤3840、比例≤3、面积655360–8294400；文生图API默认landscape_4_3，编辑auto |
+| quality | string | auto/low/medium/high/xhigh/max；API默认high |
+| background | string | auto/transparent/opaque；默认auto |
+| num_images | integer | 1–10，默认1（旧2为1–4） |
+| output_format | string | jpeg/png/webp，默认png；产品不展示、不请求 |
+| output_compression | integer | 0–100；仅jpeg/webp，产品不请求 |
+| sync_mode | boolean | 默认false；产品采用队列、不请求 |
+
+尺寸选项用合法像素明确提交；不把smart/auto直传。遮罩基于第一张参考图，通过共享派生媒体契约创建、继续编辑和源图变化失效。
+token基础价与2相同：文本输入$5/M、缓存$1.25/M；图片输入$8/M、缓存$2/M、输出$30/M。Fal端点页另写文本输出$10/M，但图像模型无文本输出。
+Fal公开实测1024方图low/medium/high约$0.0060/$0.0133/$0.0528（编辑单参考图约$0.0142/$0.0215/$0.0610）；不是固定每张价格。
+计价仅给输出参考估算，采用APIMart公开同型号尺寸/token参考表乘Fal输出单价，明确跨来源参考而非Fal报价；输入token另计，auto按max。不沿用2旧high=$0.211。
+
+## 队列契约
+
+| 事件/状态 | 前置 | 字段与空值 | 下一状态/输出 | 终态/副作用/复用 |
+|---|---|---|---|---|
+| 提交 | 未提交 | request_id非空，status_url/response_url/cancel_url由服务返回 | 保存ID和同源URL，pending | 独立HTTP |
+| IN_QUEUE | 提交后 | status必需；queue_position可选 | pending | 继续轮询 |
+| IN_PROGRESS | pending | status必需；logs可为空 | pending | 继续轮询 |
+| COMPLETED | pending | 状态完成仍需读取response_url | 读取images | 不把状态响应当图片 |
+| 结果 | COMPLETED后 | images数组，ImageFile.url必须有效 | completed/images | 停止轮询 |
+| 请求/任务错误 | 任意 | HTTP错误或错误响应 | 报错 | 停止等待 |
+
+重复处理中事件允许；官方未保证严格顺序。取消API为PUT cancel_url；本次沿用SDK现有本地取消，不新增远端取消动作。取消/超时释放本地等待，不承诺退费。空结果拒绝；复用既有Fal同源URL校验、轮询与取消测试。
+官方字面示例与字段表位于 `tests/fixtures/gpt-image-2.5/`；无付费真网证据。
+
+## 原始链接索引
+
+均公开无需登录：
+- [Flare文生图](https://fal.ai/models/openai/gpt-image-2.5/flare/text-to-image/llms.txt)
+- [Flare编辑](https://fal.ai/models/openai/gpt-image-2.5/flare/edit/llms.txt)
+- [Sunburst文生图](https://fal.ai/models/openai/gpt-image-2.5/sunburst/text-to-image/llms.txt)
+- [Sunburst编辑](https://fal.ai/models/openai/gpt-image-2.5/sunburst/edit/llms.txt)
+- [Fal实测价格表](https://fal.ai/gpt-image-2.5)
+- [队列协议](https://fal.ai/docs/documentation/model-apis/inference/queue)
+- [同型号尺寸与输出token参考表](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5/generation.md)

package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Grsai.md

@@ -1,53 +1,59 @@
-# GPT Image 2.5 · Grsai
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-10 |
-| 模型 | gpt-image-2.5 / gpt-image-2.5-flare / gpt-image-2.5-sunburst |
-| 文档/价格 | 公开无需登录；模型页已核对充值档位 |
-| 价格 | 600 / 2000 / 2400积分每次；基础充值档分别¥0.06 / ¥0.20 / ¥0.24 |
-
-公告中的¥0.03 / ¥0.10 / ¥0.12基于¥999充值档每元20000积分；¥10档每元10000积分。SDK延续基础档无优惠上限口径，不能直接把公告优惠价作为所有用户价格。
-2026-09-10公告将Flare/Sunburst从3000积分分别降到2000/2400。旧2标准/VIP为600/2000积分：2.5标准及Flare与旧对应渠道同价，Sunburst更贵。
-
-## 请求
-
-全球 `https://grsaiapi.com`，国内 `https://grsai.dakka.com.cn`；Bearer API Key。
-JSON `POST /v1/api/generate`；共享provider固定`replyType=async`，查询`GET /v1/api/result?id=...`。
-
-| 字段 | 类型 | 约束 |
-|---|---|---|
-| model | string，必填 | 上述三个ID |
-| prompt | string，必填 | 提示词 |
-| images | string[]，可选 | URL/base64；官方未给张数上限，应用保留16张本地上限，不宣称官方限制 |
-| aspectRatio | string | 标准2.5仅1K，比例或1K像素；Flare/Sunburst必须像素，不能比例 |
-| quality | string，可选 | 标准只auto；Flare low/medium/high；Sunburst另支持xhigh/max |
-| background | string，可选 | 只有Flare/Sunburst支持transparent；关闭时省略 |
-| replyType | string | json/stream/async；SDK采用async |
-
-默认Flare、智能比例、1K、medium；版本显式选择标准/Flare/Sunburst。
-标准隐藏分辨率、质量、背景；不把标准渠道映射为Flare，因为官方未确认底层型号。
-无图/有图同接口自动生成/编辑。图片使用既有主进程媒体预处理，不提供URL文本框。
-没有imageSize、n、output_format，不发送。参考尺寸完全采用当前Grsai字段表；1:3/3:1官方只给1K与4K，2K不展示、不静默降至1K。
-Flare/Sunburst像素最大边3840、16倍数、长宽比≤3、面积655360–8294400。
-文档quality总列表和逐模型说明不同，采用更具体的逐模型表；旧示例model=2却background=transparent，与字段说明冲突，原样保存但不作为2.5请求范本。
-
-## 事件契约
-
-| 状态 | 前置 | 字段/空值语义 | 下一状态/输出 | 终态/副作用/复用 |
-|---|---|---|---|---|
-| running | 提交后 | id/status必需string；results未就绪可缺失，progress可选 | pending | 独立HTTP轮询 |
-| succeeded | pending | id/status必需；results[].url必须有有效值 | completed | 停止轮询 |
-| failed | 任意 | id/status/error，error说明失败 | provider_task_failed | 停止轮询，返积分 |
-| violation | 任意 | 同失败但独立状态 | provider_task_failed | 停止轮询，2.5返积分 |
-
-重复running合法；官方未说明乱序、断线续接、远端取消/连接复用。SDK取消/超时停止本地计时与网络，不保证远端撤销。空终态拒绝。
-官方字面响应与字段表保存至 `tests/fixtures/gpt-image-2.5/`；复用现有Grsai provider状态机测试，无付费真网证据。
-
-## 原始链接索引
-
-均公开无需登录：
-- [生成接口：模型、质量、透明背景、完整像素表](https://qmy27nhsd9.apifox.cn/452409160e0.md)
-- [轮询与错误响应](https://qmy27nhsd9.apifox.cn/452409577e0.md)
-- [实时模型积分及充值档位](https://grsai.ai/zh/dashboard/models)
-- [9月9日上新与9月10日降价公告](https://grsai.ai/zh/dashboard/announcements)
+# GPT Image 2.5 · Grsai
+
+当前状态（2026-10-12）：Flare/Sunburst 自2026-10-05起维护，运行目录仅保留标准渠道；下文两个变体的参数与价格是历史采集记录，恢复并复核官方契约后再加回。
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 模型 | gpt-image-2.5 / gpt-image-2.5-flare / gpt-image-2.5-sunburst |
+| 文档/价格 | 公开无需登录；模型页已核对充值档位 |
+| 价格 | 600 / 2000 / 2400积分每次；基础充值档分别¥0.06 / ¥0.20 / ¥0.24 |
+
+公告中的¥0.03 / ¥0.10 / ¥0.12基于¥999充值档每元20000积分；¥10档每元10000积分。SDK延续基础档无优惠上限口径，不能直接把公告优惠价作为所有用户价格。
+2026-09-10公告将Flare/Sunburst从3000积分分别降到2000/2400。旧2标准/VIP为600/2000积分：2.5标准及Flare与旧对应渠道同价，Sunburst更贵。
+
+## 请求
+
+全球 `https://grsaiapi.com`，国内 `https://grsai.dakka.com.cn`；Bearer API Key。
+JSON `POST /v1/api/generate`；共享provider固定`replyType=async`，查询`GET /v1/api/result?id=...`。
+
+| 字段 | 类型 | 约束 |
+|---|---|---|
+| model | string，必填 | 上述三个ID |
+| prompt | string，必填 | 提示词 |
+| images | string[]，可选 | URL/base64；官方未给张数上限，应用保留16张本地上限，不宣称官方限制 |
+| aspectRatio | string | 标准2.5仅1K，比例或1K像素；Flare/Sunburst必须像素，不能比例 |
+| quality | string，可选 | 标准只auto；Flare low/medium/high；Sunburst另支持xhigh/max |
+| background | string，可选 | 只有Flare/Sunburst支持transparent；关闭时省略 |
+| replyType | string | json/stream/async；SDK采用async |
+
+默认Flare、智能比例、1K、medium；版本显式选择标准/Flare/Sunburst。
+标准隐藏分辨率、质量、背景；不把标准渠道映射为Flare，因为官方未确认底层型号。
+无图/有图同接口自动生成/编辑。图片使用既有主进程媒体预处理，不提供URL文本框。
+没有imageSize、n、output_format，不发送。参考尺寸完全采用当前Grsai字段表；1:3/3:1官方只给1K与4K，2K不展示、不静默降至1K。
+Flare/Sunburst像素最大边3840、16倍数、长宽比≤3、面积655360–8294400。
+文档quality总列表和逐模型说明不同，采用更具体的逐模型表；旧示例model=2却background=transparent，与字段说明冲突，原样保存但不作为2.5请求范本。
+
+## 事件契约
+
+| 状态 | 前置 | 字段/空值语义 | 下一状态/输出 | 终态/副作用/复用 |
+|---|---|---|---|---|
+| running | 提交后 | id/status必需string；results未就绪可缺失，progress可选 | pending | 独立HTTP轮询 |
+| succeeded | pending | id/status必需；results[].url必须有有效值 | completed | 停止轮询 |
+| failed | 任意 | id/status/error，error说明失败 | provider_task_failed | 停止轮询，返积分 |
+| violation | 任意 | 同失败但独立状态 | provider_task_failed | 停止轮询，2.5返积分 |
+
+重复running合法；官方未说明乱序、断线续接、远端取消/连接复用。SDK取消/超时停止本地计时与网络，不保证远端撤销。空终态拒绝。
+官方字面响应与字段表保存至 `tests/fixtures/gpt-image-2.5/`；复用现有Grsai provider状态机测试，无付费真网证据。
+
+## 原始链接索引
+
+均公开无需登录：
+- [生成接口：模型、质量、透明背景、完整像素表](https://qmy27nhsd9.apifox.cn/452409160e0.md)
+- [轮询与错误响应](https://qmy27nhsd9.apifox.cn/452409577e0.md)
+- [实时模型积分及充值档位](https://grsai.ai/zh/dashboard/models)
+- [9月9日上新与9月10日降价公告](https://grsai.ai/zh/dashboard/announcements)
+
+## 2026-10-12 渠道状态
+
+2026-10-05 起 Flare / Sunburst 维护，当前从可选渠道移除；恢复后重新加回。标准渠道可用、仍为 600 积分，基础充值档 ¥0.06。来源：[公告](https://grsai.ai/dashboard/announcements)、[当前模型状态](https://grsai.ai/dashboard/models)（本次公开可读，无需登录）。旧变体规格仅作为恢复时的历史资料，不能视为现行可调用契约。

package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_KIE.md

@@ -1,55 +1,55 @@
-# GPT Image 2.5 · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-10 |
-| 模态 | 图片；独立于 GPT Image 2 保留 |
-| model ID | `gpt-image-2-5-{flare,sunburst}-{text-to-image,image-to-image}` |
-| 文档与价格 | 公开，无需登录；已实际展开模型页四个型号 |
-| 定价 | 两个版本、文生图/编辑均为 1K $0.03、2K $0.05、4K $0.08/张；不计充值赠送 |
-
-## 请求契约
-
-`https://api.kie.ai`，Bearer API Key；`POST /api/v1/jobs/createTask`，JSON `{model,input}`。
-`input.prompt` 必填，1–20000 字符；编辑分支额外必填 `input.input_urls: string[]`，最多16张。
-模型页限制参考图 JPEG/PNG/WebP/JPG，单文件30MB。媒体沿用 KIE 官方上传与 SDK 预处理。
-
-| input 字段 | 类型 | 值与约束 |
-|---|---|---|
-| aspect_ratio | string | auto、1:1、3:2、2:3、4:3、3:4、16:9、9:16、21:9、27:16、16:27、9:8、8:9 |
-| resolution | string | 1K、2K、4K；27:16、16:27、9:8、8:9 仅1K |
-| background | string | transparent、opaque、auto |
-
-版本显式选择 Flare/Sunburst；无图/有图自动选择文生图/编辑。应用默认 Flare、智能比例、1K、auto 背景。
-智能比例在本地按首图匹配合法比例，无图1:1；高分辨率时排除仅1K的比例。
-没有 quality、n、mask、output_format 字段，不从 OpenAI 或旧模型补入。
-`callBackUrl` 可选，项目使用轮询而不发送回调。
-
-## 事件与失败契约
-
-提交成功 `{code:200,msg:"success",data:{taskId}}`；`GET /api/v1/jobs/recordInfo?taskId=...` 查询。
-
-| 事件/状态 | 前置 | 字段与空值语义 | 下一状态/输出 | 终态与副作用/复用 |
-|---|---|---|---|---|
-| 提交 | 未提交 | data.taskId 必需非空 string | 保存taskId，pending | 开始轮询，HTTP独立请求 |
-| waiting | 提交后 | data.state string；未完成不得依赖resultJson | pending | 继续轮询 |
-| queuing | 提交后 | 同上 | pending | 继续轮询 |
-| generating | 提交后 | 同上 | pending | 继续轮询 |
-| success | pending | resultJson 为JSON字符串，图像结果在resultUrls数组；必须有有效URL | completed/images | 停止轮询 |
-| fail | pending | failCode/failMsg 提供原因 | provider_task_failed | 停止轮询 |
-| HTTP/API错误 | 任意请求 | 401/402/422/429等，以供应商错误为准 | 报错 | 不冒充成功 |
-
-官方没有明确保证状态严格有序、连接复用、断线恢复或远端取消。SDK允许重复处理中状态；取消/超时停止本地轮询并释放计时器，不保证撤销计费。空成功结果拒绝。复用既有 KIE provider 与轮询测试。
-查询文档的字面“成功”示例矛盾：`data.state=success` 却带 `code=505`。fixture 原样保留并验证不会返回成功；合成正例仅改为 `code=200`，明确不属于官方原样或真网日志。
-
-官方字段表与字面示例保存在 `tests/fixtures/gpt-image-2.5/`，合成负例单独标记；本次不代表付费真网验收。
-
-## 原始链接索引
-
-均已公开访问，无需登录：
-- [Flare 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-5-flare-text-to-image.md)
-- [Flare 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-5-flare-image-to-image.md)
-- [Sunburst 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-text-to-image.md)
-- [Sunburst 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-image-to-image.md)
-- [查询协议](https://docs.kie.ai/market/common/get-task-detail.md)
-- [模型页及实时价格](https://kie.ai/gpt-image-2-5)
+# GPT Image 2.5 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 模态 | 图片；独立于 GPT Image 2 保留 |
+| model ID | `gpt-image-2-5-{flare,sunburst}-{text-to-image,image-to-image}` |
+| 文档与价格 | 公开，无需登录；已实际展开模型页四个型号 |
+| 定价 | 两个版本、文生图/编辑均为 1K $0.03、2K $0.05、4K $0.08/张；不计充值赠送 |
+
+## 请求契约
+
+`https://api.kie.ai`，Bearer API Key；`POST /api/v1/jobs/createTask`，JSON `{model,input}`。
+`input.prompt` 必填，1–20000 字符；编辑分支额外必填 `input.input_urls: string[]`，最多16张。
+模型页限制参考图 JPEG/PNG/WebP/JPG，单文件30MB。媒体沿用 KIE 官方上传与 SDK 预处理。
+
+| input 字段 | 类型 | 值与约束 |
+|---|---|---|
+| aspect_ratio | string | auto、1:1、3:2、2:3、4:3、3:4、16:9、9:16、21:9、27:16、16:27、9:8、8:9 |
+| resolution | string | 1K、2K、4K；27:16、16:27、9:8、8:9 仅1K |
+| background | string | transparent、opaque、auto |
+
+版本显式选择 Flare/Sunburst；无图/有图自动选择文生图/编辑。应用默认 Flare、智能比例、1K、auto 背景。
+智能比例在本地按首图匹配合法比例，无图1:1；高分辨率时排除仅1K的比例。
+没有 quality、n、mask、output_format 字段，不从 OpenAI 或旧模型补入。
+`callBackUrl` 可选，项目使用轮询而不发送回调。
+
+## 事件与失败契约
+
+提交成功 `{code:200,msg:"success",data:{taskId}}`；`GET /api/v1/jobs/recordInfo?taskId=...` 查询。
+
+| 事件/状态 | 前置 | 字段与空值语义 | 下一状态/输出 | 终态与副作用/复用 |
+|---|---|---|---|---|
+| 提交 | 未提交 | data.taskId 必需非空 string | 保存taskId，pending | 开始轮询，HTTP独立请求 |
+| waiting | 提交后 | data.state string；未完成不得依赖resultJson | pending | 继续轮询 |
+| queuing | 提交后 | 同上 | pending | 继续轮询 |
+| generating | 提交后 | 同上 | pending | 继续轮询 |
+| success | pending | resultJson 为JSON字符串，图像结果在resultUrls数组；必须有有效URL | completed/images | 停止轮询 |
+| fail | pending | failCode/failMsg 提供原因 | provider_task_failed | 停止轮询 |
+| HTTP/API错误 | 任意请求 | 401/402/422/429等，以供应商错误为准 | 报错 | 不冒充成功 |
+
+官方没有明确保证状态严格有序、连接复用、断线恢复或远端取消。SDK允许重复处理中状态；取消/超时停止本地轮询并释放计时器，不保证撤销计费。空成功结果拒绝。复用既有 KIE provider 与轮询测试。
+查询文档的字面“成功”示例矛盾：`data.state=success` 却带 `code=505`。fixture 原样保留并验证不会返回成功；合成正例仅改为 `code=200`，明确不属于官方原样或真网日志。
+
+官方字段表与字面示例保存在 `tests/fixtures/gpt-image-2.5/`，合成负例单独标记；本次不代表付费真网验收。
+
+## 原始链接索引
+
+均已公开访问，无需登录：
+- [Flare 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-5-flare-text-to-image.md)
+- [Flare 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-5-flare-image-to-image.md)
+- [Sunburst 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-text-to-image.md)
+- [Sunburst 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-image-to-image.md)
+- [查询协议](https://docs.kie.ai/market/common/get-task-detail.md)
+- [模型页及实时价格](https://kie.ai/gpt-image-2-5)

package/docs/model-adaptation/GPT-Image-2.6/GPT-Image-2.6_APIMart.md

@@ -0,0 +1,101 @@
+# GPT Image 2.6 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-gpt-image-2.6`（通用标识 `gpt-image-2.6`） |
+| 平台模型 ID | Ext：`gpt-image-2.6-ext`（`version` 选 `flare` / `sunburst`）；官方：`gpt-image-2.6-flare`、`gpt-image-2.6-sunburst` |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- Base URL：`https://api.apimart.ai`（备用线路见 [供应商/APIMart.md](../供应商/APIMart.md)）
+- 鉴权：`Authorization: Bearer <API_KEY>`
+- 提交：`POST /v1/images/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`，完成后读 `data.result.images[].url[]`，失败读 `data.error.message`
+
+## 2. 能力与渠道
+
+| 渠道 | 模型 | 能力 | 计费 |
+|---|---|---|---|
+| Ext | `gpt-image-2.6-ext` + `version` | 文生图、最多 16 张参考图的图生图；当前只开放 `1k`；`n` 只能 1（2–4 会建任务后失败退款） | 按张 |
+| 官方 | `gpt-image-2.6-flare` / `-sunburst` | 文生图、最多 16 张参考图编辑、蒙版、标注层、GIF、SVG；1k/2k/4k；`n` 1–4 | 按 token |
+
+Flare 速度优先，Sunburst 细节与编辑一致性优先；两者价格与参数相同。
+
+## 3. 请求参数
+
+### 3.1 官方渠道（`gpt-image-2.6-flare` / `-sunburst`）
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `gpt-image-2.6-flare` / `gpt-image-2.6-sunburst` | 必填 |
+| `prompt` | ≤ 32,000 字符 | 必填 |
+| `size` | `auto` / 15 种比例（`1:1` `3:2` `2:3` `4:3` `3:4` `5:4` `4:5` `16:9` `9:16` `2:1` `1:2` `21:9` `9:21` `3:1` `1:3`）/ 精确像素 | 默认 `auto` |
+| `resolution` | `1k` / `2k` / `4k`（小写） | 默认 `1k` |
+| `quality` | `low` / `medium` / `high` / `xhigh` / `max` / `auto` | 默认 `auto`，按 `max` 预扣 |
+| `n` | 1–4 | |
+| `output_format` | `png` / `jpeg` / `webp` / `gif` / `svg` | 项目不显示、不请求 |
+| `output_compression` | 0–100 | 项目不显示、不请求 |
+| `background` | `transparent` / `opaque` / `auto` | 透明只配 png / webp |
+| `moderation` | `auto` / `low` | 默认 `low`，项目不请求 |
+| `image_urls` | ≤ 16 张 | 公网 URL 或 Data URL |
+| `mask_url` | 透明 PNG | 需配 `image_urls`，不能与标注层同用 |
+| `markup_url` / `markup` | 透明 PNG 标注层 | 需配 `image_urls` |
+| `complexity` | `low` / `medium` / `high` | 规划强度，上游默认 `high`，不单独收费，仅 2.6 支持 |
+| `frame_count` / `frame_duration_ms` | GIF 专用 | 项目不请求 |
+| `svg` | `{ model, reasoning }` | SVG 专用，项目不请求 |
+| `safety_identifier` | ≤ 128 字符 | 项目不请求 |
+
+尺寸映射与 GPT Image 2.5 相同（例 `1:1`：1k 1024×1024、2k 2048×2048、4k 2880×2880）。
+
+### 3.2 Ext 渠道（`gpt-image-2.6-ext`）
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `gpt-image-2.6-ext` | 必填 |
+| `version` | `flare` / `sunburst` | 默认 `flare` |
+| `resolution` | 当前仅 `1k` | `2k` / `4k` 返回 403 `model_price_not_configured` |
+| `size` / `aspect_ratio` | `auto` 或 10 种比例：`1:1` `3:2` `2:3` `4:3` `3:4` `5:4` `4:5` `16:9` `9:16` `21:9` | 不接受像素值 |
+| `n` | 1 | 2–4 建任务后失败退款 |
+| `quality` | `auto` / `low` / `medium` / `high` / `xhigh` / `max` | 不影响价格 |
+| `complexity` | `low` / `medium` / `high` | 不影响价格 |
+| `output_format` | `png` / `jpeg` / `webp` / `svg` / `gif` | 项目不请求 |
+| `image_urls` | ≤ 16 张，每张 ≤ 20 MB | |
+| 不生效字段 | `background` / `moderation` / `output_compression` / `seed` / `negative_prompt` / `style` | 传入不报错但无效 |
+| 报 400 字段 | `width` / `height` / `markup` / `markup_url` | |
+
+## 4. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) 与 [GPT Image 2.6 模型页](https://apimart.ai/zh/model/gpt-image-2-6)（2026-11-07 读取，黄金价 = 当前价，1 Credit ≈ $0.1）。
+
+| 渠道 | 规格 | 单价 |
+|---|---|---|
+| Ext | flare@1K / sunburst@1K | $0.0085 / 张 |
+| 官方 | 文本输入 / 缓存文本输入 | $4 / $1 每 1M tokens |
+| 官方 | 图片输入 / 缓存图片输入 | $6.4 / $1.6 每 1M tokens |
+| 官方 | 图片输出 | $24 / 1M tokens |
+
+官方渠道输出 token：模型页说明“相较 2.5，low 输出 token 消耗为 4.2 倍，medium 为 3.3 倍，high、xhigh、max 不变”。模型页预估示例 1:1 / 1k / 低质量约 824 token ≈ $0.0198，与 2.5 表 196 token × 4.2 吻合。`auto` 按 `max` 预扣、实测通常按 `low` 结算。
+
+## 5. 项目适配
+
+- 一个产品模型：顶层 `role: 'channel'` 渠道（默认 Ext）+ `role: 'mode'` 版本（Flare / Sunburst）。
+- 比例默认“智能”：按首图比例取最近的支持比例，无图回退 `1:1`；Ext 渠道裁剪为 10 种比例。
+- 分辨率、数量、背景只在官方渠道显示；Ext 固定发 `resolution: "1k"`、`n: 1`。
+- 质量、规划强度两个渠道都发送（Ext 不影响价格）。
+- 估价：Ext $0.0085；官方按 2.5 尺寸 token 表 × 2.6 倍率 × $24/1M 估算输出，提示词与参考图输入另计。
+- 不显示、不请求：`output_format`、`output_compression`、`moderation`、GIF / SVG 专属字段、`safety_identifier`、`seed`、负面提示词。
+- 暂未接入：蒙版（`mask_url`）与标注层（`markup_url`）——需要派生媒体创作闭环，沿用 2.5 APIMart 的范围。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 官方渠道 API 文档 | https://docs.apimart.ai/cn/api-reference/images/gpt-image-2.6/generation | 否 |
+| Ext 渠道 API 文档 | https://docs.apimart.ai/cn/api-reference/images/gpt-image-2.6-ext/generation | 否 |
+| 模型页（价格、token 倍率） | https://apimart.ai/zh/model/gpt-image-2-6 | 否 |
+| 定价中心 | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/GPT-Image-2.6/GPT-Image-2.6_Fal.md

@@ -0,0 +1,55 @@
+# GPT Image 2.6 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `openai/gpt-image-2.6/{flare,sunburst}/{text-to-image,edit}` |
+| 痕迹AI 模型 ID | `fal-ai-gpt-image-2.6`（canonical `gpt-image-2.6`） |
+| 接口形态 | Fal 队列异步 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求参数（OpenAPI，2026-11-07 读取；Flare 与 Sunburst 字段相同）
+
+与 [GPT Image 2.5 · Fal](../GPT-Image-2.5/GPT-Image-2.5_Fal.md) 相比新增：
+
+| 字段 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `reasoning_effort` | string | `high` | `low` / `medium` / `high`；出图前的规划程度（OpenAI `complexity`），独立于 `quality` |
+| `output_format` | string | `png` | 新增 `gif`（动图）与 `svg`（仅文生图）；按产品约定不展示、不下发 |
+| `frame_count` / `frame_duration_ms` | integer | 9 / 200 | 仅 GIF；未接入 |
+| `svg_model` | string | `gpt-6-astra` | 仅 SVG；未接入 |
+| `markup_image_url` | string | — | 仅编辑：只含标注的透明 PNG，与 `mask_url` 互斥；未接入 |
+
+沿用字段：`prompt`（必填）、`image_size`（预设名、`{width,height}` 或 `auto`；宽高为 16 的倍数、最长边 3840、宽高比 ≤3:1、总像素 655,360–8,294,400）、`quality`（`auto/low/medium/high/xhigh/max`，默认 `high`）、`background`（`auto/transparent/opaque`）、`num_images`（1–10）、编辑端 `image_urls`（必填，≤16）、`mask_url`（白色区域重绘）。
+
+响应：`{ "images": [{ "url", ... }] }`。
+
+## 2. 价格（模型页 pricingInfoOverride，2026-11-07 读取）
+
+| 类别 | 输入 | 缓存输入 | 输出 |
+|---|---|---|---|
+| 文本 token（每百万） | $5.00 | $1.25 | $10.00 |
+| 图像 token（每百万） | $8.00 | $2.00 | $30.00 |
+
+与 2.5 单价相同。页面称“规范尺寸费用见页面底部说明”，但抓取内容中没有该表；痕迹AI 沿用 2.5 的同型号尺寸/token 参考表（APIMart 公开表）按 $30/百万输出 token 估算，提示词与参考图输入另计。
+
+## 3. 适配要点
+
+- 「版本」Flare / Sunburst 切端点；有图自动走 `edit`，无图走 `text-to-image`。
+- 比例 + 分辨率（1K/2K/4K）换算成具体 `image_size`，智能比例按首图匹配最近比例，无图回退 1:1。
+- 新增「构思深度」参数映射 `reasoning_effort`。
+- 遮罩复用 GPT Image 2 已登记的遮罩创作契约，`mask_url` 通过 `runtimeConstraints.mediaFields` 上传。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Flare 文生图 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=openai/gpt-image-2.6/flare/text-to-image | 否 |
+| Flare 编辑 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=openai/gpt-image-2.6/flare/edit | 否 |
+| Sunburst 文生图 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=openai/gpt-image-2.6/sunburst/text-to-image | 否 |
+| Sunburst 编辑 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=openai/gpt-image-2.6/sunburst/edit | 否 |
+| 模型页与价格 | https://fal.ai/models/openai/gpt-image-2.6/flare/text-to-image | 否 |
+| 尺寸/token 参考表（估算用） | https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5/generation.md | 否 |

package/docs/model-adaptation/GPT-Image-2.6/GPT-Image-2.6_Grsai.md

@@ -0,0 +1,32 @@
+# GPT Image 2.6 · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `grsai-gpt-image-2.6`，通用标识 `gpt-image-2.6` |
+| 平台 model | `gpt-image-2.6`（标准渠道） |
+| 文档与价格 | 公开，无需登录 |
+| 定价 | 每次 600 积分；基础充值档约 ¥0.06，高额充值档低至 ¥0.03（模型列表页按“积分/20000”给出参考价 ¥0.03） |
+
+## 请求契约
+
+沿用 [Grsai 供应商文档](../供应商/Grsai.md) 的 `POST /v1/api/generate` 与 `GET /v1/api/result` 异步轮询，provider 在发送边界统一补 `replyType: "async"`。
+
+| 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| model | `gpt-image-2.6` | 固定 |
+| prompt | 必填 | 统一提示词 |
+| images | base64 或 URL，官方未写数量上限 | 本地图内联 base64 |
+| aspectRatio | 比例格式或 1K 像素值；比例表与 gpt-image-2 相同：1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9、9:21、1:2、2:1 | 智能比例本地转具体值 |
+| quality | 标准渠道只支持 auto | 不显示、不请求 |
+
+模型列表页写“可生成 GIF 图，支持 1K”，但接口文档未给出 GIF 请求字段，按产品约定不开放输出格式。
+
+文档的模型枚举还列出 `gpt-image-2.6-flare`、`gpt-image-2.6-sunburst`，但 2026-11-07 模型列表页没有这两个渠道的价格，未接入。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [GPT Image 系列接口](https://qmy27nhsd9.apifox.cn/452409160e0.md)
+- [模型列表与价格](https://grsai.com/zh/dashboard/models)
+- [充值档位](https://grsai.com/zh/dashboard/billing)

package/docs/model-adaptation/GPT-Image-2.6/GPT-Image-2.6_KIE.md

@@ -0,0 +1,51 @@
+# GPT Image 2.6 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 图片；独立于 GPT Image 2.5 保留（参数集与计费方式不同） |
+| 项目模型 | `kie-gpt-image-2.6`，通用标识 `gpt-image-2.6` |
+| model ID | `gpt-image-2-6/{flare,sunburst,economy}-{text-to-image,image-to-image}` |
+| 文档与价格 | 公开，无需登录 |
+| 定价 | Flare/Sunburst 按 Token：文本输入 $4.5、缓存文本 $1.125、图片输入 $7.2、缓存图片 $1.8、图片输出 $27 每百万 Token；Economy 文生图/编辑 1K $0.025/张 |
+
+## 请求契约
+
+`https://api.kie.ai`，Bearer API Key；`POST /api/v1/jobs/createTask`，JSON `{model,input}`，`callBackUrl` 可选（项目轮询，不发送）。版本由用户显式选择，有无参考图自动选择文生图/编辑端点。
+
+| input 字段 | Flare / Sunburst | Economy | 项目处理 |
+|---|---|---|---|
+| prompt | 必填，1–32000 字符 | 必填，1–20000 字符 | 统一提示词 |
+| input_urls | 编辑必填，≤16 张，jpeg/png/webp | 编辑可选，≤16 张，单张 ≤30MB | 上传素材 |
+| aspect_ratio | auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3 | auto、1:1、16:9、9:16、3:2、2:3、21:9、4:3 | 智能比例本地按首图转具体值，无图 1:1；切到 Economy 时裁剪菜单并复位 |
+| resolution | 1K/2K/4K，默认 1K | 无 | Economy 不发送 |
+| quality | low/medium/high/xhigh/max/auto，默认 medium | 无 | 同上 |
+| complexity | low/medium/high，默认 high，不单独收费 | 无 | 同上 |
+| background | transparent/opaque/auto | 同左 | 展示 |
+| mask_url | 编辑可选，与 markup 互斥 | 无 | 复用共享遮罩编辑器，`runtimeConstraints.mediaFields` 声明 `mask_url` |
+| markup | 编辑可选透明 PNG 标注 | 无 | 不显示、不请求 |
+| output_format / output_compression / size / frame_count / frame_duration_ms / svg | GIF 与 SVG 输出相关 | output_format 仅 png/gif | 按产品约定不显示、不请求（默认 png） |
+| moderation | auto/low，默认 low | 无 | 不显示、不请求 |
+
+Flare 与 Sunburst 同价同参；Sunburst 侧重细节与多轮编辑一致性。静态图像素映射与 2.5 相同（例如 16:9 1K 1536×864、4K 3840×2160）。
+
+## 计价说明
+
+Flare/Sunburst 官方只给 Token 单价，没有每张价格。项目按 2.5 同尺寸输出 Token 参考表（`shared/gptImage25Pricing.ts`，像素映射与 2.6 官方表一致）× $27/M 估算输出费，提示词与参考图输入另计；自动质量按 max 预估，标记为估算价。Economy 为固定每张价。
+
+## 事件与失败契约
+
+沿用 [KIE 供应商文档](../供应商/KIE.md) 第 2 节 Market 统一任务契约：提交返回 `data.taskId`，`GET /api/v1/jobs/recordInfo` 查询 `waiting/queuing/generating/success/fail`，成功结果在 `resultJson.resultUrls`。本模型未引入新的轮询或解析分支。官方请求 schema 保存在 `tests/fixtures/model-requests-2026-11/kie-gpt-image-2.6-*.json`，由 `tests/catalog/kie-grsai-2026-11.test.ts` 校验；未做付费真网验收。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Flare 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-6-flare-text-to-image.md)
+- [Flare 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-6-flare-image-to-image.md)
+- [Sunburst 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-6-sunburst-text-to-image.md)
+- [Sunburst 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-6-sunburst-image-to-image.md)
+- [Economy 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-6-economy-text-to-image.md)
+- [Economy 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-6-economy-image-to-image.md)
+- [模型页（Token 单价说明）](https://kie.ai/gpt-image-2-6)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对 Flare/Sunburst Token 行与 Economy 1K 行）
+- [同尺寸输出 Token 参考表（2.5）](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5/generation.md)