@henjicc/ai-sdk 0.5.1 → 0.6.0

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

@@ -1,6 +1,47 @@
 # 小米 MiMo
 
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录（文档站是 SPA，curl 拿不到正文，用浏览器渲染后取 `innerText`，见采集手册）。
+> 核对时间：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/model-adaptation/GLM-5.3-Flash/GLM-5.3-Flash_/346/231/272/350/260/261.md

@@ -205,3 +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；缓存写入限时免费，不登记为永久零价。公开无需登录，未执行付费调用。旧文中的“结构化输出未核验”由本节取代。

package/docs/model-adaptation/HappyHorse-1.1/HappyHorse-1.1_KIE.md

@@ -0,0 +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 测试验证。

package/docs/model-adaptation/README.md

@@ -5,19 +5,27 @@
 
 | 项目 | 内容 |
 |---|---|
-| 最后更新 | 2026-09-21 |
+| 最后更新 | 2026-09-24 |
 | 模型数量 | 生成主清单 20（图片 11 / 视频 9）+ 主清单外存量 12 + SDK 跨项目能力模型 20（ASR 15 / 翻译 3 / LLM 2） |
 | 模型供应商文档数量 | 生成/存量 84 + SDK 跨项目能力 20（另有 Fal 工具 12） |
 | 覆盖供应商 | 火山引擎（官方生成/ASR）、百炼（官方）、硅基流动（官方 ASR）、智谱（官方 LLM）、Groq（官方 LLM/ASR）、APIMart、KIE、Fal、派欧云、魔搭、Grsai |
 
-另有 12 个按能力按需分发的 Fal 图像工具，不进入默认 109 模型兼容目录：
+另有 12 个按能力按需分发的 Fal 图像工具，不进入默认 111 模型兼容目录：
 
 - 消除：[Flux Pro Erase](Flux-Pro-Erase/Flux-Pro-Erase_Fal.md)、[Bria Eraser](Bria-Eraser/Bria-Eraser_Fal.md)、[Finegrain Eraser](Finegrain-Eraser/Finegrain-Eraser_Fal.md)。
 - 图片实用工具：[Image Apps v2 重打光](Image-Apps-v2-重打光/Image-Apps-v2-重打光_Fal.md)、[ControlLight](ControlLight/ControlLight_Fal.md)、[Image Apps v2 扩图](Image-Apps-v2-扩图/Image-Apps-v2-扩图_Fal.md)、[Image Apps v2 商品摄影](Image-Apps-v2-商品摄影/Image-Apps-v2-商品摄影_Fal.md)、[Image Apps v2 照片修复](Image-Apps-v2-照片修复/Image-Apps-v2-照片修复_Fal.md)、[Pixelcut 背景移除](Pixelcut-背景移除/Pixelcut-背景移除_Fal.md)。
 - 多角度：[Qwen Image Edit 2511 多角度](Qwen-Image-Edit-2511-多角度/Qwen-Image-Edit-2511-多角度_Fal.md)、[透视变换](透视变换/透视变换_Fal.md)、[FLUX 2 多角度](FLUX-2-多角度/FLUX-2-多角度_Fal.md)。
 
-工具均复用 Fal 队列、上传与结果解析；它们是独立的按需 SDK 入口，不是新的执行内核。Henji-AI 运行客户端显式装载三个 pack，但普通模型选择器仍固定为 109 个默认模型：六个图片实用工具通过图片能力菜单创建固定模型节点，三个多角度工具由专用多角度节点选择，消除工具保留给后续遮罩能力接入。真实质量、延迟和账单仍待获得付费授权后验证。
+工具均复用 Fal 队列、上传与结果解析；它们是独立的按需 SDK 入口，不是新的执行内核。Henji-AI 运行客户端显式装载三个 pack，但普通模型选择器仍固定为 111 个默认模型：六个图片实用工具通过图片能力菜单创建固定模型节点，三个多角度工具由专用多角度节点选择，消除工具保留给后续遮罩能力接入。真实质量、延迟和账单仍待获得付费授权后验证。
 
+## 2026-09-24 已适配更新
+
+- [HappyHorse 1.1 · KIE](HappyHorse-1.1/HappyHorse-1.1_KIE.md)：文生、图生与多图参考。
+- [Seedream 5.0 Flash · 火山方舟](Seedream-5.0-Flash/Seedream-5.0-Flash_火山引擎.md)：生成、编辑与图层拆分。
+- [GLM Flash / FlashX](GLM-5.3-Flash/GLM-5.3-Flash_智谱.md)：新增 FlashX 与 JSON 契约。
+- [百炼 ASR](供应商/百炼.md)：新增 Qwen-Audio 3.1 三种语音识别协议预设。
+- [MiMo 2.6 与 Responses](../llm-adaptation/供应商/小米MiMo.md)、[Kimi 缓存价格](../llm-adaptation/供应商/Kimi.md)。
+
 ## 一、目录结构约定
 
 ### 文本 Embedding / Rerank（2026-09-11）

package/docs/model-adaptation/Seedream-5.0-Flash/Seedream-5.0-Flash_/347/201/253/345/261/261/345/274/225/346/223/216.md

@@ -0,0 +1,18 @@
+# Seedream 5.0 Flash · 火山方舟
+
+核对日期：2026-09-24；公开无需登录，未执行付费生成。
+
+来源：[发布公告](https://docs.volcengine.com/docs/ark/model-release-announcement?lang=zh)、[Pro / Flash 教程](https://docs.volcengine.com/docs/ark/seedream-5-0-pro?lang=zh)、[价格](https://docs.volcengine.com/docs/ark/model-pricing?lang=zh)。官方明确基础调用只替换 Model ID，公共契约复用 Pro 实现。
+
+- Model ID：`doubao-seedream-5-0-flash-260915`；`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`，Bearer 认证。
+- 文生、图生/多图参考、交互编辑、图层拆分；输入上限 10 张，拆分必须 1 张；1K/1.5K/2K，PNG/JPEG；Flash 只支持标准提示词优化。
+- SDK 沿用 Pro 的生成/编辑与拆分模式、图片上传、智能比例和结构化图层输出。旧 Pro 参数名与模型 ID 保持不变。
+- 输入图免费，输出 ¥0.12/张；拆分数量只有返回后可知，提交前返回不可估算，不能显示 ¥0.12 为整单总价。
+
+| 响应 | 字段与行为 |
+|---|---|
+| 同步成功 | `data` 图片数组，`url` 字符串；由共享图片适配器收集 URL |
+| 图层拆分 | 与 Pro 相同的 layers/base-image 元数据，经 `parseSeedreamLayerStack` 返回结构化图层 |
+| 错误、缺失产物、取消 | 沿共享 Volcengine provider 失败收口；不把空结果当成功，不建立重复收费重试 |
+
+官方字面调用中的 Pro Model ID 可按同页明确说明替换成 Flash；测试将此区别标为官方字段构造，不能冒充 Flash 真网样本。共享 Pro 正反测试继续运行，新增 Flash 定向验证模型路由、图片限制、价格和拆分不可估算。

package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//347/231/276/347/202/274.md

@@ -249,3 +249,22 @@ Qwen-MT 可通过 OpenAI 兼容 `POST /compatible-mode/v1/chat/completions` 或
 | 提交/轮询/结果 | oss://及X-DashScope-OssResourceResolve；原有状态契约不变 | 完成转写输出 | 上传失败不提交识别；取消停止轮询，不宣称撤销远端任务 |
 
 实际时长不是仅由文件大小决定；PCM需采样率/声道/位深及payload字节数，压缩格式需要元数据时长，缺失返回null。新契约不自动修复只抛中文字符串的旧RPC桥。官方凭证fixture：tests/fixtures/bailian/asr-upload-policy.json；其余响应复用原有官方ASR fixtures，未生成付费请求。
+
+## 2026-09-24 Qwen-Audio 3.1 ASR
+
+公开官方文档无需登录：[短音频 HTTP](https://help.aliyun.com/zh/model-studio/fun-asr-flash-recorded-speech-recognition-http-api)、[文件转写](https://help.aliyun.com/zh/model-studio/fun-asr-recorded-speech-recognition-http-api)、[实时客户端](https://help.aliyun.com/zh/model-studio/fun-asr-client-events)、[实时服务端](https://help.aliyun.com/zh/model-studio/fun-asr-server-events)。未执行付费请求。
+
+新增 qwen-audio-3.1-asr-flash / -filetrans / -streaming，分别复用 Fun 短音频、异步文件和 duplex WebSocket 契约，不能套用旧 Qwen3 Chat / Realtime API。域名支持宿主注入工作空间 apiBaseUrl / funWebSocketUrl，不猜工作空间 ID。短音频远端文件上限 2 GB / 5 分钟；Base64 文档仍要求编码后 10 MB，内联原始限制 7.5 MB。文件转写≤2 GB / 12h，分离建议≤2h。
+
+| 协议事件 | 字段与状态规则 |
+|---|---|
+| 短音频 JSON / SSE result | output.text 累计文本；sentence 或分离时 sentences 数组；sentence_end:boolean，speaker_id:integer/null，begin_time/end_time 毫秒。短于一分钟可直接返回 JSON，不能强制只读 SSE |
+| 句末 | 合并去重句子，保留 speaker_id；usage.duration 秒，3.1 另有 input/output/total_tokens |
+| HTTP / SSE 错误 | code/message 非成功时抛错；畸形 JSON 或无文本拒绝 |
+| 文件提交/轮询 | input.file_urls:string[]（单文件），parameters 必须传对象；PENDING→RUNNING→SUCCEEDED/FAILED；results[].subtask_status 单独核对，成功读取 transcription_url |
+| WS | run-task→task-started→result-generated→finish-task→task-finished；task-failed 终止；未知事件沿共享状态机处理 |
+| 取消/断连/超时 | 使用 AbortSignal / 共享 WebSocket 生命周期释放；不创建第二个计费任务 |
+
+新增 keepDialect 和即时 vocabulary 参数；实时支持 vadModel。短音频说话人分离发送 speaker_diarization_enabled，文件转写发送 diarization_enabled。文件 channel_id 必须是整数数组，公共单声道选择 channelId 映射为 [channelId]；旧 Qwen3 file_url 契约不改变。短音频 sample_rate 按官方字符串发送，用户上下文 type=input_text。speakerId 作为可选公共输出字段，旧调用兼容。短音频按 tokens 计费，文件与实时不能沿用其 token 单价；未新增不可靠费用计算器。
+
+精确测试复用既有共享异步/实时失败、取消与释放测试，并补充 3.1 JSON/SSE、说话人分离、空 parameters 与新参数路由。样本区分字面与字段构造。

package/examples/form-renderer/package.json

@@ -7,7 +7,7 @@
     "start": "npm run build && node dist/cli.js"
   },
   "dependencies": {
-    "@henjicc/ai-sdk": "0.5.0"
+    "@henjicc/ai-sdk": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/examples/llm-chat/README.md

@@ -1,11 +1,17 @@
 # llm-chat
 
-用 `@henjicc/ai-sdk@0.4.1` 的 `llm/streaming` 按需入口走 OpenAI-compatible SSE 流式对话，
+用 `@henjicc/ai-sdk@0.5.2` 的 `llm/streaming` 按需入口走 OpenAI-compatible SSE 流式对话，
 不会把 generation、BigModel preset/models/pricing、Groq 或 LLM modules 打进示例 bundle；
 通用端点身份解析所需的 BigModel profiles 仍会保留。默认目标是
 DeepSeek `deepseek-v4-flash`，提示词要求只回复 `SDK OK`，并限制最多 16 tokens。示例显式传入
 `reasoning: { enabled: false, effort: 'high' }`，避免短输出预算被供应商默认思考过程占用；若流结束后
-没有任何文本 token，示例会明确失败。
+没有任何文本 token，示例会明确失败。
+
+输出上限使用有类型定义的 `maxOutputTokens`。省略时 SDK 不再自动写入 4096；调用方可以按字幕长度
+和模型上限选择更大的值。`runLlmChatStream` 的执行参数不传 `timeoutMs` 时没有请求总时限，CEP
+网络适配可在 `Transport` 中实现“长时间无数据才超时”。正式结构化输出可通过
+`structuredOutput` 选择 `text`、`json_object` 或带 `name/schema/strict` 的 `json_schema`，并通过
+`capabilities.structuredOutputMode` 与 `structuredOutputWithReasoning` 明确声明模型能力。
 
 ```bash
 npm install

package/examples/llm-chat/index.ts

@@ -68,7 +68,7 @@ async function main(): Promise<void> {
     reasoning: providerId === 'deepseek'
       ? { enabled: false, effort: 'high' }
       : undefined,
-    policy: { max_tokens: 16 },
+    maxOutputTokens: 16,
   }
   const taskId = resolveLlmTaskId(request)
   let output = ''

package/examples/llm-chat/package.json

@@ -9,7 +9,7 @@
     "start": "npm run build && node dist/index.js --live"
   },
   "dependencies": {
-    "@henjicc/ai-sdk": "0.5.0"
+    "@henjicc/ai-sdk": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/examples/minimal-node/package.json

@@ -8,7 +8,7 @@
     "start": "npm run build && node dist/index.js --live"
   },
   "dependencies": {
-    "@henjicc/ai-sdk": "0.5.0"
+    "@henjicc/ai-sdk": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",