@henjicc/ai-sdk 0.6.1 → 0.7.0

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

@@ -1,66 +1,66 @@
-# GPT Image 2.5 · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-10 |
-| 模态 | 图片；不替换 GPT Image 2 |
-| 官方渠道 | `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst` |
-| Ext渠道 | `model=gpt-image-2.5-ext`，`version=flare/sunburst` |
-| 文档/价格 | 公开，无需登录；模型页与Ext Tab均已实际展开 |
-
-## 请求与价格
-
-Base URL `https://api.apimart.ai`；Bearer API Key；JSON `POST /v1/images/generations`。
-共享 provider 已发送 `Idempotency-Key` 和 `X-APIMart-Response-Version: 2026-07-27`，无需为模型另建协议。
-`prompt` 必填非空；`image_urls: string[]` 最多16张，有图即编辑；`n` 为整数1–4，默认1。
-官方渠道只接受公开HTTP(S)参考图，使用官方 `POST /v1/uploads/images` 上传；Ext还接受data URL。
-
-| 参数 | 官方渠道 | Ext渠道 |
-|---|---|---|
-| 版本 | 编码进model | version=flare/sunburst，默认flare |
-| size | 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、4:3、3:4、3:2、2:3、5:4、4:5、21:9 |
-| resolution | 1k/2k/4k，默认1k；像素size时忽略 | 1K/2K/4K，默认1K |
-| quality | auto/low/medium/high/xhigh/max，API默认auto | 未定义，不发送 |
-| background | auto/opaque/transparent | 未定义，不发送 |
-| moderation | auto/low，服务默认low | 未定义，不发送 |
-| output_format | png/jpeg/webp，默认png | 未定义 |
-| output_compression | 0–100，仅jpeg/webp | 未定义 |
-
-产品一个入口，渠道先于版本；默认Ext、Flare、智能比例、1K、1张；官方质量使用medium（与平台playground初始值一致）。
-智能比例本地计算，无图1:1。output_format/output_compression/moderation/seed不展示、不发送；默认PNG允许透明背景。
-新版官方文档未定义mask，不沿用2的mask字段。Ext不能显示质量和背景。
-
-Ext实时基础价两个版本相同：1K $0.0085、2K $0.014、4K $0.021/张，参考图不额外收费。
-官方渠道实际公开价每百万token：文本输入$4、缓存$1、图片输入$6.4、缓存$1.6、图片输出$24。
-API正文$5/$1.25/$8/$2/$30是OpenAI原价；按实时价格页20%折扣采用上述平台价，不与充值优惠混淆。
-官方页面提供不同尺寸的输出token参考表；估算按size/resolution/quality/n计算输出部分，不含提示词及参考图输入；auto保守按max。
-1024方图low/medium/high/xhigh/max分别196/439/1756/3122/7024输出token。
-两版token单价一致不保证旧版与新版每张费用一致；官方文档说明2.5 medium/high输出token约为2同名档四分之一。
-
-## 任务状态契约
-
-`GET /v1/tasks/{task_id}`，同用户API Key。返回URL位于`data.result.images[].url[]`。
-
-| 事件 | 前置 | 字段与空值语义 | 下一状态/输出 | 终态/副作用/复用 |
-|---|---|---|---|---|
-| HTTP202提交 | 未提交 | data.id非空string，object=generation.task，status=pending；poll_url可用 | 保存ID，pending | 独立HTTP请求 |
-| HTTP200兼容提交 | 未提交 | data数组，data[0].task_id非空string、status=submitted | 保存ID，pending | 兼容旧格式 |
-| pending/submitted | 提交后 | status非空；结果可未就绪 | pending | 继续轮询 |
-| processing | pending | progress数值，不能代替终态 | pending | 继续轮询 |
-| completed | pending | result.images须有有效URL；usage/cost可提供实际计费 | completed | 停止轮询并保存结果 |
-| failed | pending | error.message说明原因 | 报错 | 停止轮询，平台退还预留资金 |
-| canceled/cancelled | pending | 查询协议取消终态 | 报错 | 停止轮询 |
-| HTTP400/401/402/429 | 任意请求 | error对象 | 报错 | 不盲重放生成 |
-
-允许重复pending；官方未保证严格状态顺序及断线恢复。SDK取消/超时结束本地等待，不保证远端撤销；空成功拒绝；复用既有provider释放规则。
-官方示例/字段表见 `tests/fixtures/gpt-image-2.5/`；未进行付费请求。
-
-## 原始链接索引
-
-以下无需登录，已实测正文：
-- [官方渠道完整参数、尺寸及输出token表](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5/generation.md)
-- [Ext完整参数与版本响应](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5-ext/generation.md)
-- [任务查询](https://docs.apimart.ai/en/api-reference/tasks/status.md)
-- [模型页及两个渠道的实时价格](https://apimart.ai/zh/model/gpt-image-2-5)
-- [实时定价](https://apimart.ai/zh/pricing)
-- [OpenAI费用边界](https://developers.openai.com/api/docs/models/gpt-image-2.5-flare)
+# GPT Image 2.5 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 模态 | 图片；不替换 GPT Image 2 |
+| 官方渠道 | `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst` |
+| Ext渠道 | `model=gpt-image-2.5-ext`，`version=flare/sunburst` |
+| 文档/价格 | 公开，无需登录；模型页与Ext Tab均已实际展开 |
+
+## 请求与价格
+
+Base URL `https://api.apimart.ai`；Bearer API Key；JSON `POST /v1/images/generations`。
+共享 provider 已发送 `Idempotency-Key` 和 `X-APIMart-Response-Version: 2026-07-27`，无需为模型另建协议。
+`prompt` 必填非空；`image_urls: string[]` 最多16张，有图即编辑；`n` 为整数1–4，默认1。
+官方渠道只接受公开HTTP(S)参考图，使用官方 `POST /v1/uploads/images` 上传；Ext还接受data URL。
+
+| 参数 | 官方渠道 | Ext渠道 |
+|---|---|---|
+| 版本 | 编码进model | version=flare/sunburst，默认flare |
+| size | 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、4:3、3:4、3:2、2:3、5:4、4:5、21:9 |
+| resolution | 1k/2k/4k，默认1k；像素size时忽略 | 1K/2K/4K，默认1K |
+| quality | auto/low/medium/high/xhigh/max，API默认auto | 未定义，不发送 |
+| background | auto/opaque/transparent | 未定义，不发送 |
+| moderation | auto/low，服务默认low | 未定义，不发送 |
+| output_format | png/jpeg/webp，默认png | 未定义 |
+| output_compression | 0–100，仅jpeg/webp | 未定义 |
+
+产品一个入口，渠道先于版本；默认Ext、Flare、智能比例、1K、1张；官方质量使用medium（与平台playground初始值一致）。
+智能比例本地计算，无图1:1。output_format/output_compression/moderation/seed不展示、不发送；默认PNG允许透明背景。
+新版官方文档未定义mask，不沿用2的mask字段。Ext不能显示质量和背景。
+
+Ext实时基础价两个版本相同：1K $0.0085、2K $0.014、4K $0.021/张，参考图不额外收费。
+官方渠道实际公开价每百万token：文本输入$4、缓存$1、图片输入$6.4、缓存$1.6、图片输出$24。
+API正文$5/$1.25/$8/$2/$30是OpenAI原价；按实时价格页20%折扣采用上述平台价，不与充值优惠混淆。
+官方页面提供不同尺寸的输出token参考表；估算按size/resolution/quality/n计算输出部分，不含提示词及参考图输入；auto保守按max。
+1024方图low/medium/high/xhigh/max分别196/439/1756/3122/7024输出token。
+两版token单价一致不保证旧版与新版每张费用一致；官方文档说明2.5 medium/high输出token约为2同名档四分之一。
+
+## 任务状态契约
+
+`GET /v1/tasks/{task_id}`，同用户API Key。返回URL位于`data.result.images[].url[]`。
+
+| 事件 | 前置 | 字段与空值语义 | 下一状态/输出 | 终态/副作用/复用 |
+|---|---|---|---|---|
+| HTTP202提交 | 未提交 | data.id非空string，object=generation.task，status=pending；poll_url可用 | 保存ID，pending | 独立HTTP请求 |
+| HTTP200兼容提交 | 未提交 | data数组，data[0].task_id非空string、status=submitted | 保存ID，pending | 兼容旧格式 |
+| pending/submitted | 提交后 | status非空；结果可未就绪 | pending | 继续轮询 |
+| processing | pending | progress数值，不能代替终态 | pending | 继续轮询 |
+| completed | pending | result.images须有有效URL；usage/cost可提供实际计费 | completed | 停止轮询并保存结果 |
+| failed | pending | error.message说明原因 | 报错 | 停止轮询，平台退还预留资金 |
+| canceled/cancelled | pending | 查询协议取消终态 | 报错 | 停止轮询 |
+| HTTP400/401/402/429 | 任意请求 | error对象 | 报错 | 不盲重放生成 |
+
+允许重复pending；官方未保证严格状态顺序及断线恢复。SDK取消/超时结束本地等待，不保证远端撤销；空成功拒绝；复用既有provider释放规则。
+官方示例/字段表见 `tests/fixtures/gpt-image-2.5/`；未进行付费请求。
+
+## 原始链接索引
+
+以下无需登录，已实测正文：
+- [官方渠道完整参数、尺寸及输出token表](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5/generation.md)
+- [Ext完整参数与版本响应](https://docs.apimart.ai/en/api-reference/images/gpt-image-2.5-ext/generation.md)
+- [任务查询](https://docs.apimart.ai/en/api-reference/tasks/status.md)
+- [模型页及两个渠道的实时价格](https://apimart.ai/zh/model/gpt-image-2-5)
+- [实时定价](https://apimart.ai/zh/pricing)
+- [OpenAI费用边界](https://developers.openai.com/api/docs/models/gpt-image-2.5-flare)

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,53 @@
-# 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-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)

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/HappyHorse-1.1/HappyHorse-1.1_KIE.md

@@ -1,27 +1,27 @@
-# HappyHorse 1.1 · KIE
-
-核对日期：2026-09-24；公开页面，无需登录；未执行付费生成。
-
-官方接口：[文生视频](https://docs.kie.ai/38309290e0.md)、[图生视频](https://docs.kie.ai/38308980e0.md)、[参考图视频](https://docs.kie.ai/38309489e0.md)。价格来自 [官方模型页](https://kie.ai/happyhorse-1-1) 的三个模式页：均为 720p 22.5 credits/s（$0.1125/s）、1080p 29 credits/s（$0.145/s），不计充值赠送。
-
-统一使用 `POST https://api.kie.ai/api/v1/jobs/createTask`，Bearer 认证；`model` 分别是 `happyhorse-1-1/text-to-video`、`image-to-video`、`reference-to-video`。共享任务查询 `GET /api/v1/jobs/recordInfo?taskId=...`，不用回调接收服务。
-
-| 模式 | input 必填与约束 | 禁止混入的字段 |
-|---|---|---|
-| 文生 | prompt；resolution 720p/1080p，duration 整数 3–15 默认 5；aspect_ratio 默认 16:9 | image_urls、reference_image |
-| 图生 | image_urls 数组，恰好 1 张；prompt 可省略；resolution、duration 同上 | aspect_ratio、reference_image |
-| 参考 | reference_image 1–9 张，prompt；resolution、duration、aspect_ratio 同文生 | image_urls |
-
-比例：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。参考图顺序对应提示词 `[Image 1]` 等编号。图生图像为 JPG/PNG/WEBP、≤20 MB、宽高均≥300、比例 0.4–2.5；参考图最短边≥400、≤20 MB。文件经官方 KIE 上传入口回填，界面不提供 URL 输入框。
-
-文生 prompt 的 schema `maxLength=4999` 与说明 5000 有冲突，SDK 采用较严格 4999；图生/参考上限 5000，超限报错，不截断。中文长度建议≤2500；素材像素/内容最终由服务端校验。界面一个模型、标准/参考两个模式，标准按是否有图片选择文生或图生。
-
-| 事件/响应 | 类型与可空性 | 行为 |
-|---|---|---|
-| 创建成功 | code:number=200，data.taskId:string | 返回 pending；缺 ID 且无产物拒绝 |
-| 查询等待 | data.state:string=waiting/queuing/generating | 有界轮询，不重复创建 |
-| 查询成功 | state=success，resultJson:string 内含 resultUrls:string[]；failCode/failMsg 可为 null | 返回产物；缺 URL 报错 |
-| 查询失败 | state=fail，failCode/failMsg:string；resultJson 可空或省略 | 失败终止 |
-| 查询错误、超时、取消 | 非 200 / 超预算 / AbortSignal | 沿共享 KIE/polling 收口，不误判成功、不付费重放 |
-
-字面请求、创建响应及成功/失败回调示例保存在 `tests/fixtures/kie/happyhorse-1.1-*.json`；回调只作为结果字段样本，不代表 SDK 接收回调。正常请求、边界、价格与共享轮询负例由目录测试和既有 provider/polling 测试验证。
+# HappyHorse 1.1 · KIE
+
+核对日期：2026-09-24；公开页面，无需登录；未执行付费生成。
+
+官方接口：[文生视频](https://docs.kie.ai/38309290e0.md)、[图生视频](https://docs.kie.ai/38308980e0.md)、[参考图视频](https://docs.kie.ai/38309489e0.md)。价格来自 [官方模型页](https://kie.ai/happyhorse-1-1) 的三个模式页：均为 720p 22.5 credits/s（$0.1125/s）、1080p 29 credits/s（$0.145/s），不计充值赠送。
+
+统一使用 `POST https://api.kie.ai/api/v1/jobs/createTask`，Bearer 认证；`model` 分别是 `happyhorse-1-1/text-to-video`、`image-to-video`、`reference-to-video`。共享任务查询 `GET /api/v1/jobs/recordInfo?taskId=...`，不用回调接收服务。
+
+| 模式 | input 必填与约束 | 禁止混入的字段 |
+|---|---|---|
+| 文生 | prompt；resolution 720p/1080p，duration 整数 3–15 默认 5；aspect_ratio 默认 16:9 | image_urls、reference_image |
+| 图生 | image_urls 数组，恰好 1 张；prompt 可省略；resolution、duration 同上 | aspect_ratio、reference_image |
+| 参考 | reference_image 1–9 张，prompt；resolution、duration、aspect_ratio 同文生 | image_urls |
+
+比例：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。参考图顺序对应提示词 `[Image 1]` 等编号。图生图像为 JPG/PNG/WEBP、≤20 MB、宽高均≥300、比例 0.4–2.5；参考图最短边≥400、≤20 MB。文件经官方 KIE 上传入口回填，界面不提供 URL 输入框。
+
+文生 prompt 的 schema `maxLength=4999` 与说明 5000 有冲突，SDK 采用较严格 4999；图生/参考上限 5000，超限报错，不截断。中文长度建议≤2500；素材像素/内容最终由服务端校验。界面一个模型、标准/参考两个模式，标准按是否有图片选择文生或图生。
+
+| 事件/响应 | 类型与可空性 | 行为 |
+|---|---|---|
+| 创建成功 | code:number=200，data.taskId:string | 返回 pending；缺 ID 且无产物拒绝 |
+| 查询等待 | data.state:string=waiting/queuing/generating | 有界轮询，不重复创建 |
+| 查询成功 | state=success，resultJson:string 内含 resultUrls:string[]；failCode/failMsg 可为 null | 返回产物；缺 URL 报错 |
+| 查询失败 | state=fail，failCode/failMsg:string；resultJson 可空或省略 | 失败终止 |
+| 查询错误、超时、取消 | 非 200 / 超预算 / AbortSignal | 沿共享 KIE/polling 收口，不误判成功、不付费重放 |
+
+字面请求、创建响应及成功/失败回调示例保存在 `tests/fixtures/kie/happyhorse-1.1-*.json`；回调只作为结果字段样本，不代表 SDK 接收回调。正常请求、边界、价格与共享轮询负例由目录测试和既有 provider/polling 测试验证。

package/docs/model-adaptation/IC-Light-v2/IC-Light-v2_Fal.md

@@ -2,7 +2,7 @@
 
 | 项目 | 内容 |
 |---|---|
-| 最后更新 | 2026-09-10 |
+| 最后更新 | 2026-09-10 |
 | 模态 | 图片编辑 / 重打光 |
 | 供应商 | fal.ai（聚合平台） |
 | 平台模型 ID | `fal-ai/iclight-v2` |
@@ -30,20 +30,20 @@ IC-Light v2 接收一张源图，通过文字描述和离散的初始光照偏
 | `prompt` | string | 是 | — | 由手动模式提示词编译器生成 |
 | `image_url` | string | 是 | — | 恰好一张源图，由现有 Fal 上传链路提供 |
 | `initial_latent` | enum | 否 | `None` | 仅 `None` / `Left` / `Right` / `Top` / `Bottom` |
-| `image_size` | enum/object | 否 | — | 按源图实际比例计算约 1MP 自定义整数宽高，不吸附到预设比例；两边均为 1–14142 |
+| `image_size` | enum/object | 否 | — | 按源图实际比例计算约 1MP 自定义整数宽高，不吸附到预设比例；两边均为 1–14142 |
 | `num_images` | integer | 否 | `1` | 固定 `1` |
 | `num_inference_steps` | integer | 否 | `28` | 固定 `28` |
-| `cfg` | number | 否 | `1` | 固定 `1`，范围 0.01–5；旧文档的 `cfg_scale` 不属于官方字段 |
+| `cfg` | number | 否 | `1` | 固定 `1`，范围 0.01–5；旧文档的 `cfg_scale` 不属于官方字段 |
 | `guidance_scale` | number | 否 | `5` | 固定 `5` |
 | `lowres_denoise` | number | 否 | `0.98` | 固定 `0.98` |
 | `highres_denoise` | number | 否 | `0.95` | 固定 `0.95` |
-| `hr_downscale` | number | 否 | `0.5` | 固定 `0.5`，范围 0.01–1；旧文档的 `highres_scale` 不属于官方字段 |
+| `hr_downscale` | number | 否 | `0.5` | 固定 `0.5`，范围 0.01–1；旧文档的 `highres_scale` 不属于官方字段 |
 | `enable_hr_fix` | boolean | 否 | `false` | 固定 `false`，首版避免额外成本与时延 |
 | `enable_safety_checker` | boolean | 否 | `true` | 固定 `true` |
-| `mask_image_url` | string | 否 | — | 首版不开放 |
+| `mask_image_url` | string | 否 | — | 首版不开放 |
 | `negative_prompt` | string | 否 | — | 不展示、不发送 |
 | `seed` | integer | 否 | — | 不展示、不发送 |
-| `output_format` | enum | 否 | `jpeg` | 不展示、不发送，沿用供应商默认 |
+| `output_format` | enum | 否 | `jpeg` | 不展示、不发送，沿用供应商默认 |
 
 ## 4. 请求示例
 
@@ -52,14 +52,14 @@ IC-Light v2 接收一张源图，通过文字描述和离散的初始光照偏
   "prompt": "Preserve the subject and composition. Apply a soft warm key light from the left.",
   "image_url": "https://.../source.png",
   "initial_latent": "Left",
-  "image_size": { "width": 1365, "height": 768 },
+  "image_size": { "width": 1365, "height": 768 },
   "num_images": 1,
   "num_inference_steps": 28,
-  "cfg": 1,
+  "cfg": 1,
   "guidance_scale": 5,
   "lowres_denoise": 0.98,
   "highres_denoise": 0.95,
-  "hr_downscale": 0.5,
+  "hr_downscale": 0.5,
   "enable_hr_fix": false,
   "enable_safety_checker": true
 }
@@ -70,17 +70,17 @@ IC-Light v2 接收一张源图，通过文字描述和离散的初始光照偏
 ```json
 {
   "images": [
-    { "url": "https://...", "width": 1365, "height": 768, "content_type": "image/jpeg" }
+    { "url": "https://...", "width": 1365, "height": 768, "content_type": "image/jpeg" }
   ]
 }
 ```
 
 Fal 模型页公开价格为 **$0.10/百万像素**。首版固定约 1MP、单张输出，目录保守估算为 **$0.10/次**。实际账单仍以 Fal 返回和账户账单为准，登录后的额度、地区可用性与最终账单尚待真实验证。
 
-## 6. 错误与降级
-
-- 2026-09-10 重核官方 OpenAPI：自定义宽高合法，不存在只能选择五种比例的限制。旧代码把约 2:3 原图选成约 3:4 输出，属于本地请求尺寸策略错误；改为直接使用源图比例，仅有整数像素舍入误差。上传原图和下载结果不作非等比拉伸，也不为预设比例额外裁切。Fal 内部如何变换图像未在公开 schema 中说明，不能把输出人物变化全部归因于本地缩放。
-- 亮度、色调和轮廓光只有提示词意图，没有对应数值 API 字段；颜色传达正确不代表生成结果能精确还原预览。手动提示词将主光颜色放在开头，并明确彩色光照射主体，仍需真实生成评估效果。
+## 6. 错误与降级
+
+- 2026-09-10 重核官方 OpenAPI：自定义宽高合法，不存在只能选择五种比例的限制。旧代码把约 2:3 原图选成约 3:4 输出，属于本地请求尺寸策略错误；改为直接使用源图比例，仅有整数像素舍入误差。上传原图和下载结果不作非等比拉伸，也不为预设比例额外裁切。Fal 内部如何变换图像未在公开 schema 中说明，不能把输出人物变化全部归因于本地缩放。
+- 亮度、色调和轮廓光只有提示词意图，没有对应数值 API 字段；颜色传达正确不代表生成结果能精确还原预览。手动提示词将主光颜色放在开头，并明确彩色光照射主体，仍需真实生成评估效果。
 
 - 缺少源图或源图超过一张：在请求构建前失败，不提交任务。
 - Fal 凭据、端点或余额不可用：显示明确失败，不自动切换模型。