@henjicc/ai-sdk 0.6.2 → 0.7.0

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/Kimi.md

@@ -23,7 +23,7 @@ Kimi 官方文档全文没有出现过 `responses.create`；`platform.kimi.com/d
 |---|---|---|---|---|
 | `kimi-k3` | 当前旗舰，2.8 万亿参数，KDA 混合线性注意力，全球首个开源 3 万亿级模型 | 文本、图片、视频 → 文本 | 1,048,576 tokens（1M） | 默认 131,072，最大可设 1,048,576 |
 
-价格（2026-09-24 核对，元/百万 tokens）：缓存命中 2、缓存未命中 20、输出 100；另计缓存写入，TTL 5 分钟为 20、TTL 1 小时为 40，默认 5 分钟。命中仅按缓存命中单价计费，不重复收取缓存写入费用，命中后有效期续期。当前 SDK 未提供 Kimi 账单计算器，不从总输入 tokens 猜测缓存写入量。
+价格（2026-09-24 核对，元/百万 tokens）：缓存命中 2、缓存未命中 20、输出 100；另计缓存写入，TTL 5 分钟为 20、TTL 1 小时为 40，默认 5 分钟。命中仅按缓存命中单价计费，不重复收取缓存写入费用，命中后有效期续期。当前 SDK 未提供 Kimi 账单计算器，不从总输入 tokens 猜测缓存写入量。
 
 K3 是付费解锁模型：**充值后才能调用**，新用户认证赠送的 15 元代金券不能用于 K3。
 
@@ -69,8 +69,8 @@ K3 是付费解锁模型：**充值后才能调用**，新用户认证赠送的
 - [推理强度](https://platform.kimi.com/docs/guide/use-reasoning-effort)
 - [使用 Kimi API 的联网搜索功能](https://platform.kimi.com/docs/guide/use-web-search)
 - [如何在 Kimi API 中使用官方工具](https://platform.kimi.com/docs/guide/use-official-tools)
-- [Kimi K3 定价](https://platform.kimi.com/docs/pricing/chat-k3)
-- [当前推理与缓存写入定价（2026-09-24）](https://platform.kimi.com/docs/pricing/chat.md)
+- [Kimi K3 定价](https://platform.kimi.com/docs/pricing/chat-k3)
+- [当前推理与缓存写入定价（2026-09-24）](https://platform.kimi.com/docs/pricing/chat.md)
 - [联网搜索定价](https://platform.kimi.com/docs/pricing/tools)
 - [使用思考模式](https://platform.kimi.com/docs/guide/use-thinking-models)
 - [Kimi 文档全量索引](https://platform.kimi.com/docs/llms.txt)

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//345/260/217/347/261/263MiMo.md

@@ -1,47 +1,47 @@
 # 小米 MiMo
 
-> 核对时间：2026-09-24。下方更新契约优先于历史记录；官方 Markdown 可公开读取，无需登录。
-
-## 2026-09-24 模型与协议更新
-
-官方模型 ID 为 `mimo-v2.6-pro`、`mimo-v2.6-flash`、`mimo-v2.6-pro-ultraspeed`；均支持文本/图片/音频/视频理解、思考、工具调用、结构化输出，上下文 1M、最大输出 131072 tokens。UltraSpeed 为需联系供应商开通的定制服务，仅登记能力，不加入默认推荐。旧 `mimo-v2.5-pro`、`mimo-v2.5` 于北京时间 2026-10-21 10:00 直接停用，不自动替换；SDK 保留旧 ID 的能力识别但新建预设使用 2.6，不能把旧 ID 作为新模型别名暗中重定向。
-
-价格（普通按量、元/百万 tokens）：Pro 缓存命中 0.025、未命中输入 3、输出 6；Flash 分别 0.02、1、2；UltraSpeed 分别 0.25、30、60。不把 Batch 半价或活动优惠当作基础价格。
-
-当前同时提供 `POST https://api.xiaomimimo.com/v1/chat/completions` 与 `POST https://api.xiaomimimo.com/v1/responses`；鉴权支持 `api-key` 或 Bearer。Chat 用 `thinking.type=enabled|disabled`（默认 enabled），输出限制 `max_completion_tokens`。Responses 用 `reasoning.effort`，none 关闭，其余合法档位均开启且不区分强度；输出限制 `max_output_tokens`。两协议思考开启时不能自定义 temperature/top_p（实际固定 1/0.95）；SDK 不下发无效采样值。Responses 不支持 background、previous_response_id、context_management；SDK 使用无服务端存储的完整历史请求。Chat 与 Responses 不混发私有思考字段。
-
-### Responses 事件契约
-
-官方仅提供字段表，未提供字面事件 JSON；fixture 必须标记为“依据官方字段表构造”。所有事件的 type 为对应事件名，sequence_number 为数字；下表列出的其余字段按官方字段表类型处理，官方未逐字段声明 required/nullable 的部分不补造保证。正常顺序 created → in_progress → 条目/片段 → completed 或 incomplete；重复、乱序、断线恢复和服务器取消接口未明确约定。SDK 不自动重放付费 POST，取消/断开释放流与 AbortSignal；没有有效最终输出不得视为成功。
-
-| 事件 | 字段 | 下一状态/对外行为 |
-|---|---|---|
-| response.created | response 对象 | 建立响应；空输出合法，不是 final |
-| response.in_progress | response 对象 | 继续等待，空输出合法 |
-| response.output_item.added | item 对象、output_index 数字 | 建立 message/reasoning/function_call 条目 |
-| response.output_item.done | item 对象、output_index 数字 | 条目完成；不结束整个响应 |
-| response.content_part.added | part 对象、item_id 字符串、output_index/content_index 数字 | 建立内容片段 |
-| response.content_part.done | 同 added | 片段完成；不重复输出已发 delta |
-| response.output_text.delta | delta 字符串、item_id、output_index/content_index | 增量正文 |
-| response.output_text.done | text 字符串、item_id、output_index/content_index | 正文完成 |
-| response.function_call_arguments.delta | delta 字符串、item_id、output_index | 追加工具 JSON 参数 |
-| response.function_call_arguments.done | arguments 字符串、item_id、output_index | 工具参数完成 |
-| response.reasoning_text.delta | delta 字符串、item_id、output_index/content_index | 增量思考，与正文分离 |
-| response.reasoning_text.done | text 字符串、item_id、output_index/content_index | 思考完成 |
-| response.custom_tool_call_input.delta | delta 字符串、item_id、output_index | 自定义工具输入；当前 SDK 公共工具仅支持 function，不声明此能力 |
-| response.custom_tool_call_input.done | input 字符串、item_id、output_index | 同上，不当成正文 |
-| response.completed | response 对象（output/usage/status） | 成功终态；统计用量并释放流 |
-| response.incomplete | response 对象（含 incomplete_details） | 截断终态，不伪报完整成功 |
-
-### 本轮原始链接（均公开）
-
-- 模型：https://mimo.mi.com/static/docs/quick-start/summary/model.md
-- 下线：https://mimo.mi.com/static/docs/updates/deprecate.md
-- 价格：https://mimo.mi.com/static/docs/price/pay-as-you-go.md
-- Chat 字段：https://mimo.mi.com/static/docs/api/chat/openai-api.md
-- Responses 字段及逐事件：https://mimo.mi.com/static/docs/api/chat/responses.md
-
-## 历史资料（2026-08-26，协议与模型以本轮更新为准）
+> 核对时间：2026-09-24。下方更新契约优先于历史记录；官方 Markdown 可公开读取，无需登录。
+
+## 2026-09-24 模型与协议更新
+
+官方模型 ID 为 `mimo-v2.6-pro`、`mimo-v2.6-flash`、`mimo-v2.6-pro-ultraspeed`；均支持文本/图片/音频/视频理解、思考、工具调用、结构化输出，上下文 1M、最大输出 131072 tokens。UltraSpeed 为需联系供应商开通的定制服务，仅登记能力，不加入默认推荐。旧 `mimo-v2.5-pro`、`mimo-v2.5` 于北京时间 2026-10-21 10:00 直接停用，不自动替换；SDK 保留旧 ID 的能力识别但新建预设使用 2.6，不能把旧 ID 作为新模型别名暗中重定向。
+
+价格（普通按量、元/百万 tokens）：Pro 缓存命中 0.025、未命中输入 3、输出 6；Flash 分别 0.02、1、2；UltraSpeed 分别 0.25、30、60。不把 Batch 半价或活动优惠当作基础价格。
+
+当前同时提供 `POST https://api.xiaomimimo.com/v1/chat/completions` 与 `POST https://api.xiaomimimo.com/v1/responses`；鉴权支持 `api-key` 或 Bearer。Chat 用 `thinking.type=enabled|disabled`（默认 enabled），输出限制 `max_completion_tokens`。Responses 用 `reasoning.effort`，none 关闭，其余合法档位均开启且不区分强度；输出限制 `max_output_tokens`。两协议思考开启时不能自定义 temperature/top_p（实际固定 1/0.95）；SDK 不下发无效采样值。Responses 不支持 background、previous_response_id、context_management；SDK 使用无服务端存储的完整历史请求。Chat 与 Responses 不混发私有思考字段。
+
+### Responses 事件契约
+
+官方仅提供字段表，未提供字面事件 JSON；fixture 必须标记为“依据官方字段表构造”。所有事件的 type 为对应事件名，sequence_number 为数字；下表列出的其余字段按官方字段表类型处理，官方未逐字段声明 required/nullable 的部分不补造保证。正常顺序 created → in_progress → 条目/片段 → completed 或 incomplete；重复、乱序、断线恢复和服务器取消接口未明确约定。SDK 不自动重放付费 POST，取消/断开释放流与 AbortSignal；没有有效最终输出不得视为成功。
+
+| 事件 | 字段 | 下一状态/对外行为 |
+|---|---|---|
+| response.created | response 对象 | 建立响应；空输出合法，不是 final |
+| response.in_progress | response 对象 | 继续等待，空输出合法 |
+| response.output_item.added | item 对象、output_index 数字 | 建立 message/reasoning/function_call 条目 |
+| response.output_item.done | item 对象、output_index 数字 | 条目完成；不结束整个响应 |
+| response.content_part.added | part 对象、item_id 字符串、output_index/content_index 数字 | 建立内容片段 |
+| response.content_part.done | 同 added | 片段完成；不重复输出已发 delta |
+| response.output_text.delta | delta 字符串、item_id、output_index/content_index | 增量正文 |
+| response.output_text.done | text 字符串、item_id、output_index/content_index | 正文完成 |
+| response.function_call_arguments.delta | delta 字符串、item_id、output_index | 追加工具 JSON 参数 |
+| response.function_call_arguments.done | arguments 字符串、item_id、output_index | 工具参数完成 |
+| response.reasoning_text.delta | delta 字符串、item_id、output_index/content_index | 增量思考，与正文分离 |
+| response.reasoning_text.done | text 字符串、item_id、output_index/content_index | 思考完成 |
+| response.custom_tool_call_input.delta | delta 字符串、item_id、output_index | 自定义工具输入；当前 SDK 公共工具仅支持 function，不声明此能力 |
+| response.custom_tool_call_input.done | input 字符串、item_id、output_index | 同上，不当成正文 |
+| response.completed | response 对象（output/usage/status） | 成功终态；统计用量并释放流 |
+| response.incomplete | response 对象（含 incomplete_details） | 截断终态，不伪报完整成功 |
+
+### 本轮原始链接（均公开）
+
+- 模型：https://mimo.mi.com/static/docs/quick-start/summary/model.md
+- 下线：https://mimo.mi.com/static/docs/updates/deprecate.md
+- 价格：https://mimo.mi.com/static/docs/price/pay-as-you-go.md
+- Chat 字段：https://mimo.mi.com/static/docs/api/chat/openai-api.md
+- Responses 字段及逐事件：https://mimo.mi.com/static/docs/api/chat/responses.md
+
+## 历史资料（2026-08-26，协议与模型以本轮更新为准）
 
 ## 1. 摘要
 

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//346/231/272/350/260/261GLM.md

@@ -144,9 +144,9 @@ schema 未暴露 `tool_stream`，通用字段说明列出的支持模型也未
 
 `finish_reason` 的 schema 枚举列出 `stop`、`length`、`tool_calls`、`sensitive`、`network_error`，
 但同页字段说明还提到 `model_context_window_exceeded`。这是官方页面内部不一致；解析器必须接受并保留
-未知字符串，不能用封闭枚举拒绝服务器返回。
-
-2026-09-24 复核：开放字符串不代表所有结束原因都成功。官方明确 `network_error` 为模型推理异常，SDK 原生流必须失败并保留该结束原因，不执行自动付费重放；`model_context_window_exceeded` 表示上下文窗口上限，沿用部分输出但标 `truncated=true`。`stop/tool_calls/sensitive` 及未知扩展字符串继续保留原值，供调用方依据语义处理。对应字段表 fixture 与负例位于 `tests/fixtures/llm/chat-stream-lifecycle.json` 和 `tests/llm/streaming-lifecycle.test.ts`；没有将这些构造样本声称为真实模型返回。
+未知字符串，不能用封闭枚举拒绝服务器返回。
+
+2026-09-24 复核：开放字符串不代表所有结束原因都成功。官方明确 `network_error` 为模型推理异常，SDK 原生流必须失败并保留该结束原因，不执行自动付费重放；`model_context_window_exceeded` 表示上下文窗口上限，沿用部分输出但标 `truncated=true`。`stop/tool_calls/sensitive` 及未知扩展字符串继续保留原值，供调用方依据语义处理。对应字段表 fixture 与负例位于 `tests/fixtures/llm/chat-stream-lifecycle.json` 和 `tests/llm/streaming-lifecycle.test.ts`；没有将这些构造样本声称为真实模型返回。
 
 ## 7. 结构化输出与流式能力
 

package/docs/model-adaptation/Fun-ASR-Realtime/Fun-ASR-Realtime_/347/231/276/347/202/274.md

@@ -2,7 +2,7 @@
 
 | 项目 | 内容 |
 |---|---|
-| 最后更新 | 2026-09-24 |
+| 最后更新 | 2026-09-24 |
 | 能力 | 实时语音识别（WebSocket） |
 | 平台模型 ID | `fun-asr-realtime`（稳定别名，官方当前等同 `fun-asr-realtime-2025-11-07`） |
 | 地域 | 华北2（北京）、新加坡 |
@@ -26,27 +26,27 @@
 
 Say-It 保留该稳定别名与 2026-02-28 快照供用户选择；SDK 不应自行把稳定别名锁定为某快照。空 `sentence_begin` 事件只推进状态，不产生 partial/final；重复 final 只累计一次。取消时主动关闭 socket，密钥和原始音频不记日志。
 
-## 4. 服务端事件矩阵（fun-duplex 家族）
-
-2026-09-24 核对官方服务端事件页。此协议也服务于 `qwen-audio-3.1-asr-flash-streaming`，错误诊断必须标实际模型，不能统一叫 Fun-ASR。样本见 `tests/fixtures/bailian/asr-realtime-fun.json`，0.6.1 真实验证的空中间帧保持原语义。
-
-共享百炼实时驱动在握手发送失败时也返回已归一化的模型/协议/阶段；关闭连接若再次失败，以 `cleanupFailed=true` 补充首个故障，不覆盖原因为原始宿主异常。该边界由 `bailian-realtime-asr.test.ts` 的双故障 Mock 回归保护，同时用于 `fun-duplex` 与 `qwen-realtime`。
-
-| 事件 | 前置阶段与字段语义 | 迁移 / 输出 | 结束与资源 |
-|---|---|---|---|
-| `task-started` | opening，run-task 已发 | active / started | 继续 |
-| `result-generated` 心跳 | sentence.heartbeat=true，官方明确可跳过 | 无文本、无完成迁移 | 继续 |
-| `result-generated` 中间帧 | active/finishing；text 字符串、sentence_end=false；仅首帧可有 sentence_begin | 空 text 等待，有文字 partial | 继续 |
-| `result-generated` 句终帧 | active/finishing；text 字符串、sentence_end=true | 非空 final，保存时间戳与用量；重复相同 final 不重复累计 | 继续等待任务结束 |
-| `task-finished` | finishing；payload 通常空，无须含 text | 使用累计 final；未收到有效 final 则 invalid_response | SDK 关闭；官方允许以新 task_id 复用 |
-| `task-failed` | 任一未终止阶段；header.error_code/error_message | provider_task_failed，保留 code，不默认记录完整 message | 关闭，不复用 |
-| 缺失事件名、text 或布尔 sentence_end | 不用非空文字掩盖缺失状态；心跳除外 | invalid_response | 失败并释放 |
-| 有名未知扩展 | 官方未定义行为 | 脱敏警告，无文本/完成输出 | 等待已知终态 |
-| 提前断开 / 取消 | 无最终完成证据 | 断连错误或取消 | 释放连接，不重放计费请求 |
-
-校验不要求中间帧带 sentence_begin，也不要求心跳带文本。合法空中间帧不会被当失败；空 final 和只有 partial 的任务仍不能成功。
-
-## 5. 原始链接索引
+## 4. 服务端事件矩阵（fun-duplex 家族）
+
+2026-09-24 核对官方服务端事件页。此协议也服务于 `qwen-audio-3.1-asr-flash-streaming`，错误诊断必须标实际模型，不能统一叫 Fun-ASR。样本见 `tests/fixtures/bailian/asr-realtime-fun.json`，0.6.1 真实验证的空中间帧保持原语义。
+
+共享百炼实时驱动在握手发送失败时也返回已归一化的模型/协议/阶段；关闭连接若再次失败，以 `cleanupFailed=true` 补充首个故障，不覆盖原因为原始宿主异常。该边界由 `bailian-realtime-asr.test.ts` 的双故障 Mock 回归保护，同时用于 `fun-duplex` 与 `qwen-realtime`。
+
+| 事件 | 前置阶段与字段语义 | 迁移 / 输出 | 结束与资源 |
+|---|---|---|---|
+| `task-started` | opening，run-task 已发 | active / started | 继续 |
+| `result-generated` 心跳 | sentence.heartbeat=true，官方明确可跳过 | 无文本、无完成迁移 | 继续 |
+| `result-generated` 中间帧 | active/finishing；text 字符串、sentence_end=false；仅首帧可有 sentence_begin | 空 text 等待，有文字 partial | 继续 |
+| `result-generated` 句终帧 | active/finishing；text 字符串、sentence_end=true | 非空 final，保存时间戳与用量；重复相同 final 不重复累计 | 继续等待任务结束 |
+| `task-finished` | finishing；payload 通常空，无须含 text | 使用累计 final；未收到有效 final 则 invalid_response | SDK 关闭；官方允许以新 task_id 复用 |
+| `task-failed` | 任一未终止阶段；header.error_code/error_message | provider_task_failed，保留 code，不默认记录完整 message | 关闭，不复用 |
+| 缺失事件名、text 或布尔 sentence_end | 不用非空文字掩盖缺失状态；心跳除外 | invalid_response | 失败并释放 |
+| 有名未知扩展 | 官方未定义行为 | 脱敏警告，无文本/完成输出 | 等待已知终态 |
+| 提前断开 / 取消 | 无最终完成证据 | 断连错误或取消 | 释放连接，不重放计费请求 |
+
+校验不要求中间帧带 sentence_begin，也不要求心跳带文本。合法空中间帧不会被当失败；空 final 和只有 partial 的任务仍不能成功。
+
+## 5. 原始链接索引
 
 | 信息 | 链接 | 登录 |
 |---|---|---|

package/docs/model-adaptation/GLM-5.3-Flash/GLM-5.3-Flash_/346/231/272/350/260/261.md

@@ -205,9 +205,9 @@ Coding Plan 3 倍额度扣减是订阅用量规则，不是 token 单价。SDK/
 - [国际 Quick Start](https://docs.z.ai/guides/overview/quick-start)：国际 Base URL、API Key 页面与 Flash 模型入口。
 - [国际 HTTP API](https://docs.z.ai/guides/develop/http/introduction)：国际通用端点与 Bearer 鉴权。
 - [国际价格](https://docs.z.ai/guides/overview/pricing)：USD 标准价、促销价和绝对截止时间。
-
-## 2026-09-24 官方更新
-
-[模型页](https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash.md) 现明确 Flash / FlashX 支持 JSON 结构化输出，thinking.type 只能 enabled。SDK 开放 JSON 与思考并用，未扩大到 JSON Schema；工具流仍沿标准 SSE。FlashX 仅加入大陆端点，不推断 Global 支持。上下文 1M、最大输出 128K，多模态与 Flash 相同。
-
-[官方价格](https://docs.bigmodel.cn/cn/guide/start/pricing.md)：FlashX 输入 ¥2、输出 ¥7、缓存命中 ¥0.57 / 百万 tokens；缓存写入限时免费，不登记为永久零价。公开无需登录，未执行付费调用。旧文中的“结构化输出未核验”由本节取代。
+
+## 2026-09-24 官方更新
+
+[模型页](https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash.md) 现明确 Flash / FlashX 支持 JSON 结构化输出，thinking.type 只能 enabled。SDK 开放 JSON 与思考并用，未扩大到 JSON Schema；工具流仍沿标准 SSE。FlashX 仅加入大陆端点，不推断 Global 支持。上下文 1M、最大输出 128K，多模态与 Flash 相同。
+
+[官方价格](https://docs.bigmodel.cn/cn/guide/start/pricing.md)：FlashX 输入 ¥2、输出 ¥7、缓存命中 ¥0.57 / 百万 tokens；缓存写入限时免费，不登记为永久零价。公开无需登录，未执行付费调用。旧文中的“结构化输出未核验”由本节取代。

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)