@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//347/241/205/345/237/272/346/265/201/345/212/250.md

@@ -1,88 +1,153 @@
-# 硅基流动 · 供应商基础文档
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-31 |
-| 供应商 | SiliconFlow / SiliconCloud |
-| 建议 `providerId` | `siliconflow` |
-| Base URL | `https://api.siliconflow.cn/v1` |
-| 鉴权 | `Authorization: Bearer <SILICONFLOW_API_KEY>` |
-| 已核验 ASR 类型 | 同步文件语音转写 API |
-| 文档/价格可见性 | 公开，无需登录；API Key、实名、用量和账单需登录 |
+# 硅基流动 · 供应商基础文档
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-11 |
+| 供应商 | SiliconFlow / SiliconCloud |
+| 建议 `providerId` | `siliconflow` |
+| Base URL | `https://api.siliconflow.cn/v1` |
+| 鉴权 | `Authorization: Bearer <SILICONFLOW_API_KEY>` |
+| 已核验 ASR 类型 | 同步文件语音转写 API |
+| 文档/价格可见性 | 公开，无需登录；API Key、实名、用量和账单需登录 |
+
+## LLM 与动态模型发现（2026-09-11）
 
-## 1. ASR 端点与请求
-
-```text
-POST https://api.siliconflow.cn/v1/audio/transcriptions
-Authorization: Bearer <SILICONFLOW_API_KEY>
-Content-Type: multipart/form-data
-```
-
-| 字段 | 类型 | 要求 |
-|---|---|---|
-| `file` | binary file | 必填；时长不超过 1 小时，文件不超过 50 MB |
-| `model` | enum string | 必填；`FunAudioLLM/SenseVoiceSmall` 或 `TeleAI/TeleSpeechASR` |
-
-官方端点参考目前只公开了 `file` 和 `model`，没有公开 `language`、`prompt`、
-`response_format`、词级时间戳、说话人分离或热词参数。cURL 使用 MP3 为示例，但页面未给出
-完整 MIME/容器白名单；不应仅根据开源上游模型能力自行扩展公开云 API 参数。
+本节依据国内控制台模型详情、官方 Chat Completions / Models 文档和实时价格页。控制台已登录核验；公开文档与价格页无需登录。模型名字保留大小写与厂商前缀，不把硅基流动的 DeepSeek V4 Flash 冒充 DeepSeek 官方 `deepseek-flash`（V4.1）。
 
-成功响应是 `application/json`：
+| 展示名 / API model ID | 已核验输入 / 工具 | 上下文 | 每百万 tokens 输入 / 输出 / 缓存命中（人民币） |
+|---|---|---|---|
+| DeepSeek V4 Flash / `deepseek-ai/DeepSeek-V4-Flash` | 文本 / 工具调用 | 1,000,000；模型页声明最高输出 384K | 3 / 9 / 0.3；价格页另有 2–8 点 1.5 / 4.5 / 0.15，时段以平台账单为准 |
+| GLM-5.3 / `zai-org/GLM-5.3` | 文本 / 工具调用 / 结构化输出 | 1,048,576；托管输出上限未明确，留空 | 8 / 28 / 2 |
+| Kimi K2.7 Code / `moonshotai/Kimi-K2.7-Code` | 文本、图片 / 工具调用 | 256K；托管输出上限留空 | 6.5 / 27 / 1.3 |
+| Qwen3.8-27B / `Qwen/Qwen3.8-27B` | 文本、图片 / 工具调用 | 256K；托管输出上限留空 | 3 / 12 / 未列出 |
 
-```json
-{
-  "text": "<string>"
-}
-```
+控制台价格单元格实际显示 `/K Tokens`（如 Qwen 输入 0.003、输出 0.012），虽然表头按钮写 M Tokens；上表按单元格单位换算，并与公开价格页交叉核对。Kimi/Qwen 模型介绍包含视频能力，但本次不声明视频输入：未取得该托管接口的视频消息字段契约。常用预设不是全部在售清单，动态发现结果不以预设白名单过滤。
 
-响应头 `x-siliconcloud-trace-id` 是服务端生成的请求追踪标识，可在排障时提供给官方，
-不应当成稳定业务 ID。官方未公开独立 WebSocket、SSE、异步任务或实时麦克风 ASR
-协议；本端点应按同步文件转写建模。
+### 发现接口
 
-## 2. 模型、价格与免费政策
+`GET https://api.siliconflow.cn/v1/models?sub_type=chat`，Bearer 鉴权。`sub_type` 可独立筛选，支持 `chat`、`embedding`、`reranker` 等；本 SDK 检索接口对外 `reranker` 按凭据用途映射为 `rerank`，聊天映射 `llm`。不同时传 `type=text`，避免错误排除支持视觉的聊天模型。
 
-| 平台模型 ID | API 明确列举 | 当前价格证据 | 结论 |
-|---|---:|---|---|
-| `FunAudioLLM/SenseVoiceSmall` | 是 | 公开价格页语音模型标注“免费” | 自有 Key 调用按当前免费模型政策处理 |
-| `TeleAI/TeleSpeechASR` | 是 | 通用价格页当前未找到该 ID；官方“说点啥”用例将它列入该客户端的免费服务 | **自有 Key 的通用计费未确认**，上线前必须在控制台/账单复核 |
+成功体 `{object:"list",data:[{id,object:"model",created,owned_by}]}`。官方示例只给基础身份字段，未提供价格、上下文或完整能力；未知模型保留原 ID，不根据名字猜能力。空 `data:[]` 是合法结果；缺失 data、非数组、平台错误体不得伪装为空列表。取消/超时通过宿主 AbortSignal 传递；不自动重试。SDK 不在无凭据时尝试匿名列举。
 
-免费模型不是一次性试用金：官方 Rate Limits 页明确说免费模型调用账单消耗为 0，
-同时要求账号完成实名认证。免费模型使用固定 Rate Limits，但公开页未给这两个 ASR
-模型的精确数值；不应把其它模型的 RPM/RPD 直接套用。模型转写页还明确保留定期上下线
-和调整服务能力的权利，因此发布前应再做模型可用性查询。
+### 聊天接口与事件矩阵
 
-## 3. 错误契约
+`POST https://api.siliconflow.cn/v1/chat/completions`，Bearer、JSON。必填 `model` 与 `messages`；`stream:true` 返回 SSE，以 `data: [DONE]` 结束。消息复用 OpenAI 兼容结构，图片为 `image_url` 内容块；工具为 `tools[].function`，最多 128 个。支持 `max_tokens`、`temperature`、`top_p`、`response_format`。输出上限不得直接等于上下文窗口；官方建议预留输入空间。
 
-官方转写 API 参考和通用错误页表明错误体并非始终同一形状：
+思考开关使用 `enable_thinking`，不发送 DeepSeek 原厂的 `thinking` 对象。官方字段表明确 `reasoning_effort` 仅支持 high/max，并列举 DeepSeek V4 Flash、Pro/DeepSeek V4、Pro/GLM-5.2；本次四个预设仅给 DeepSeek V4 Flash 发送该字段。关闭思考时只发 `enable_thinking:false`。其他预设发送布尔开关，不根据模型营销介绍猜强度枚举。GLM-5.3 的官方原厂能力配置不能覆盖硅基流动托管限制。
 
-- JSON 形状可为 `{ "code": 20012, "message": "...", "data": null }`；
-- 部分鉴权/权限/路由错误在 API 参考中展示为纯字符串；
-- 429 错误示例含 `message` 和 `data`，需从 `message` 区分 RPM/RPD/TPM/TPD/IPM/IPD；
-- 503/504 通常表示服务高负载，500 是未知服务异常。
+| 事件/状态 | 字段与空值语义 | 输出与状态 | 终态 / 资源 |
+|---|---|---|---|
+| HTTP 成功开始 SSE | choices 数组；delta.content 可空串、reasoning_content 可 null、finish_reason 可 null（官方 Streaming 首帧） | 空始帧不输出文本，继续读取 | 未终止；复用当前响应流 |
+| 文本/思考 delta | content / reasoning_content 字符串增量，缺失/null 不追加 | 分别输出正文与思考 | 继续读取 |
+| 工具 delta | delta.tool_calls 的 index、id、function.name/arguments；arguments 增量拼接 | 保留工具身份与参数，交共享解析器 | 继续读取 |
+| finish / usage | finish_reason 标记 stop、length、tool_calls；usage 的 prompt/completion/total 与可选 reasoning/cached tokens | 归一化终态原因和用量；usage 可随首帧出现 | 等待 DONE/结束并释放 reader |
+| `[DONE]` | SSE 数据字面值 | 结束当前响应；空有效输出按共享内核处理 | 释放 reader，不重复 POST |
+| 400/401/403/404/429/503/504 | JSON code/message/data 或纯文本；不得当成输出 | 明确失败 | 释放资源，不自动重试计费请求 |
+| 取消/超时/断流 | 官方未说明断点续传、恢复或取消退费 | 使用宿主取消与共享内核超时/断流契约 | 释放 reader/计时器；不重放 |
 
-常见 HTTP 状态：400 参数，401 凭证，403 余额/权限/实名，429 限流，500 未知服务错误，
-503/504 过载。SDK 的 `provider_http_error` 诊断文本需保留 HTTP status、可用的
-`code/message/data`、纯文本 fallback 和脱敏后的 `x-siliconcloud-trace-id`；当前通用
-`AiRuntimeError` 不提供结构化供应商错误 metadata，不可只按一种 JSON 错误结构解析。
+官方未承诺乱序、重复事件去重或断线恢复，本次沿用同一个 OpenAI SSE 执行内核，不创建硅基流动专属 parser。fixture 区分官方首帧/模型列表字面样例与依据字段构造的后续增量、工具回合及合成负例；不声称真实付费成功。
 
-## 4. Say-It/SDK 接入边界
+来源：
+- [模型列表 API](https://api-docs.siliconflow.cn/docs/api/models-get)：筛选参数、鉴权、基础身份字段和错误，公开。
+- [Chat Completions](https://api-docs.siliconflow.cn/docs/api/chat-completions-post)：LLM/VLM Tab、Streaming/Function 示例、请求字段与错误，公开。
+- [实时价格](https://siliconflow.cn/pricing)：输入/输出/缓存与时段，公开。
+- [国内模型广场](https://cloud.siliconflow.cn/me/models)：逐项查看四个模型的详情、能力、价格；本次使用已登录会话。
 
-接入复杂度低：标准 Bearer Key + `multipart/form-data` + JSON 或文本错误，无 HMAC、无二进制
-私有帧。与 OpenAI/Groq 语音转写形状接近，但当前公开字段仅有 `file/model`，不能把
-OpenAI 的 `language/prompt/response_format/temperature` 透传过来。
-
-中国大陆使用 `api.siliconflow.cn`，需 SiliconCloud 账号与 API Key；免费模型需实名认证。
-本轮没有发起真实或付费请求，运营商网络可达性、账户实际限流和 TeleSpeechASR 自有 Key
-计费均未实测。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 语音转文字 API、模型 enum、输入限制、响应字段 | https://docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
-| 当前公开价格 | https://siliconflow.cn/pricing | 否 |
-| 免费模型、实名与 Rate Limits 规则 | https://docs.siliconflow.cn/cn/userguide/rate-limits/rate-limit-and-upgradation | 否 |
-| 通用错误体与状态说明 | https://docs.siliconflow.cn/cn/faqs/error-code | 否 |
-| TeleSpeechASR/SenseVoiceSmall 客户端免费服务用例 | https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-BiBiKeyboard | 否 |
-| API Key 管理 | https://cloud.siliconflow.cn/account/ak | **是** |
-| 实名认证 | https://cloud.siliconflow.cn/account/authentication | **是** |
+## 1. ASR 端点与请求
+
+```text
+POST https://api.siliconflow.cn/v1/audio/transcriptions
+Authorization: Bearer <SILICONFLOW_API_KEY>
+Content-Type: multipart/form-data
+```
+
+| 字段 | 类型 | 要求 |
+|---|---|---|
+| `file` | binary file | 必填；时长不超过 1 小时，文件不超过 50 MB |
+| `model` | enum string | 必填；`FunAudioLLM/SenseVoiceSmall` 或 `TeleAI/TeleSpeechASR` |
+
+官方端点参考目前只公开了 `file` 和 `model`，没有公开 `language`、`prompt`、
+`response_format`、词级时间戳、说话人分离或热词参数。cURL 使用 MP3 为示例，但页面未给出
+完整 MIME/容器白名单；不应仅根据开源上游模型能力自行扩展公开云 API 参数。
+
+成功响应是 `application/json`：
+
+```json
+{
+  "text": "<string>"
+}
+```
+
+响应头 `x-siliconcloud-trace-id` 是服务端生成的请求追踪标识，可在排障时提供给官方，
+不应当成稳定业务 ID。官方未公开独立 WebSocket、SSE、异步任务或实时麦克风 ASR
+协议；本端点应按同步文件转写建模。
+
+## 2. 模型、价格与免费政策
+
+| 平台模型 ID | API 明确列举 | 当前价格证据 | 结论 |
+|---|---:|---|---|
+| `FunAudioLLM/SenseVoiceSmall` | 是 | 公开价格页语音模型标注“免费” | 自有 Key 调用按当前免费模型政策处理 |
+| `TeleAI/TeleSpeechASR` | 是 | 通用价格页当前未找到该 ID；官方“说点啥”用例将它列入该客户端的免费服务 | **自有 Key 的通用计费未确认**，上线前必须在控制台/账单复核 |
+
+免费模型不是一次性试用金：官方 Rate Limits 页明确说免费模型调用账单消耗为 0，
+同时要求账号完成实名认证。免费模型使用固定 Rate Limits，但公开页未给这两个 ASR
+模型的精确数值；不应把其它模型的 RPM/RPD 直接套用。模型转写页还明确保留定期上下线
+和调整服务能力的权利，因此发布前应再做模型可用性查询。
+
+## 3. 错误契约
+
+官方转写 API 参考和通用错误页表明错误体并非始终同一形状：
+
+- JSON 形状可为 `{ "code": 20012, "message": "...", "data": null }`；
+- 部分鉴权/权限/路由错误在 API 参考中展示为纯字符串；
+- 429 错误示例含 `message` 和 `data`，需从 `message` 区分 RPM/RPD/TPM/TPD/IPM/IPD；
+- 503/504 通常表示服务高负载，500 是未知服务异常。
+
+常见 HTTP 状态：400 参数，401 凭证，403 余额/权限/实名，429 限流，500 未知服务错误，
+503/504 过载。SDK 的 `provider_http_error` 诊断文本需保留 HTTP status、可用的
+`code/message/data`、纯文本 fallback 和脱敏后的 `x-siliconcloud-trace-id`；当前通用
+`AiRuntimeError` 不提供结构化供应商错误 metadata，不可只按一种 JSON 错误结构解析。
+
+## 4. Say-It/SDK 接入边界
+
+接入复杂度低：标准 Bearer Key + `multipart/form-data` + JSON 或文本错误，无 HMAC、无二进制
+私有帧。与 OpenAI/Groq 语音转写形状接近，但当前公开字段仅有 `file/model`，不能把
+OpenAI 的 `language/prompt/response_format/temperature` 透传过来。
+
+中国大陆使用 `api.siliconflow.cn`，需 SiliconCloud 账号与 API Key；免费模型需实名认证。
+本轮没有发起真实或付费请求，运营商网络可达性、账户实际限流和 TeleSpeechASR 自有 Key
+计费均未实测。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 语音转文字 API、模型 enum、输入限制、响应字段 | https://docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
+| 当前公开价格 | https://siliconflow.cn/pricing | 否 |
+| 免费模型、实名与 Rate Limits 规则 | https://docs.siliconflow.cn/cn/userguide/rate-limits/rate-limit-and-upgradation | 否 |
+| 通用错误体与状态说明 | https://docs.siliconflow.cn/cn/faqs/error-code | 否 |
+| TeleSpeechASR/SenseVoiceSmall 客户端免费服务用例 | https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-BiBiKeyboard | 否 |
+| API Key 管理 | https://cloud.siliconflow.cn/account/ak | **是** |
+| 实名认证 | https://cloud.siliconflow.cn/account/authentication | **是** |
+# 2026-09-11：Embedding / Rerank 核查
+
+官方公开 API：https://api-docs.siliconflow.cn/docs/api/embeddings-post 、https://api-docs.siliconflow.cn/docs/api/rerank-post 。国内根地址 `https://api.siliconflow.cn/v1`，Bearer，同步 JSON POST `/embeddings` 或 `/rerank`。
+
+- 文本 Qwen3 Embedding 8B/4B/0.6B：`Qwen/Qwen3-Embedding-{8B,4B,0.6B}`，32768 token，支持 dimensions 枚举。8B：64/128/256/512/768/1024/1536/2048/2560/4096；4B 去掉4096；0.6B 到1024。发送 input 字符串数组、encoding_format=float，读取 data[].index/embedding。BGE/BCE 也有 API 字段说明，暂不机械加入所有历史模型。
+- 文本 Qwen3 Reranker 同尺寸 ID `Qwen/Qwen3-Reranker-*`：query、documents、top_n、instruction；不能发送仅 BGE/BCE 支持的 overlap_tokens/max_chunks_per_doc。读取 results[].index/relevance_score，usage 可能位于 meta.tokens（与 billed_units 分开，不能混为实际用量）。
+- 国内价格已于 2026-09-11 使用用户已登录的 BrowserOS neo，在[模型广场](https://cloud.siliconflow.cn/me/models?types=embedding)逐个打开模型详情核验。在线推理价格按明细行的 `/ K Tokens` 单位换算为百万输入 tokens，见下表；不是国际站美元价格，也不是真实调用账单。
+- 多模态 Qwen3-VL-Embedding/Reranker-8B 另有接口变体；本次文本能力不宣称支持图片/视频。发布公告 https://www.siliconflow.cn/news/gnuv7wmztvwaq78ozfhjybmi 标明文本0.7元/百万、视觉1.8元/百万；不能借用该价格给纯文本 Qwen3。
+- 同步终态与验证：非2xx/非法JSON/供应商error拒绝；向量非空且索引完整唯一；重排索引有效唯一且分数有限；取消/超时由 capability client 统一传递。官方示例与字段构造正例、synthetic-negative 分开标注。
+
+| 精确模型 ID | 控制台输入价格（元/千 tokens） | 元/百万输入 tokens |
+|---|---:|---:|
+| Qwen/Qwen3-Embedding-8B | 0.000280 | 0.28 |
+| Qwen/Qwen3-Embedding-4B | 0.000140 | 0.14 |
+| Qwen/Qwen3-Embedding-0.6B | 0.000070 | 0.07 |
+| Qwen/Qwen3-Reranker-8B | 0.000280 | 0.28 |
+| Qwen/Qwen3-Reranker-4B | 0.000140 | 0.14 |
+| Qwen/Qwen3-Reranker-0.6B | 0.000070 | 0.07 |
+| BAAI/bge-m3 | 0.000000 | 0（当前免费） |
+| BAAI/bge-reranker-v2-m3 | 0.000000 | 0（当前免费） |
+
+控制台表头单位按钮显示 `M Tokens`，实际价格单元格明确显示 `/ K Tokens`；以上按单元格原值和单位保存、换算，不把 0.000280 误记为每百万价格。免费结论仅针对上述无 `Pro/` 前缀的两个模型；不能推及 Pro 版本或所有 BGE 模型。未触发推理、充值或修改账号配置，也不保存账号信息。列表中 BCE Embedding/Reranker 已标记 Deprecated，本轮不添加。