@henjicc/ai-sdk 0.2.8

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

@@ -0,0 +1,232 @@
+# 智谱 GLM（国内 BigModel / 国际 Z.AI）
+
+> 最后核对：2026-08-28。信息来源见文末「官方来源索引」，均为无需登录的官方页面。
+
+`glm-5.3-flash` 的模型级请求、事件、fixture、价格和编码门槛以
+[GLM-5.3-Flash_智谱.md](../../model-adaptation/GLM-5.3-Flash/GLM-5.3-Flash_智谱.md) 为唯一详细来源；
+本文件只承担智谱供应商级协议汇总。若两处摘要不一致，以模型级文件为准并同步修正本页。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| 现有 `providerId` | `bigmodel`；当前预设明确指向**国内 BigModel**，不是国际 Z.AI |
+| 供应商族设计 | 继续共用 `bigmodel` provider family / 协议内核，新增 `cn` / `global` endpoint profile；不复制两个 provider 实现 |
+| 品牌与 SDK 名称 | 国内智谱 BigModel 与国际 Z.AI 是两个官方平台入口；官方 Python SDK 名称不是运行时 provider alias |
+| 对应项目 `adapter` | `openai`（Chat Completions）；`glm-5.3` 官方还提供 Responses 与 Anthropic 协议 |
+| 鉴权 | `Authorization: Bearer <API Key>` |
+| `glm-5.3-flash` 接入结论 | 既有 `bigmodel` 供应商下的**新增独立原生多模态模型**，不是 `glm-5.3` 的别名，也不触发供应商重命名 |
+| 本轮状态 | 官方资料已核对；SDK 尚未登记 `glm-5.3-flash`，完整能力编码仍受第 9 节冲突项阻断 |
+
+`glm-5.3-flash` 的展示名为 `GLM-5.3-Flash`，官方 API Model Code 为小写的
+`glm-5.3-flash`。公开资料没有给出第二个 API 别名，不要把展示名、`Z.ai` 或 SDK 包名当成别名注册。
+
+## 2. 国内 / 国际区域矩阵与协议边界
+
+| profile | 官方平台 / 文档 | Chat Base URL | API Key 入口 | `glm-5.3-flash` | 价格币种 |
+|---|---|---|---|---|---|
+| `cn` | 智谱 BigModel / `docs.bigmodel.cn` | `https://open.bigmodel.cn/api/paas/v4` | `https://bigmodel.cn/usercenter/proj-mgmt/apikeys` | 官方模型页与 Quick Start 均列出 | CNY |
+| `global` | Z.AI / `docs.z.ai` | `https://api.z.ai/api/paas/v4` | `https://z.ai/manage-apikey/apikey-list` | 官方模型页、Quick Start 与价格页均列出 | USD |
+
+两站的 Flash 模型页确认相同的 model ID、text/image/video/file → text、1M / 128K、强制思考、
+Chat/SSE、Function Calling、缓存与推荐参数。它们不是同一个 API 域名，价格和账户入口也不同。
+官方没有声明国内与国际账号、余额或 API Key 可以互通；在没有官方依据和真网验证时，必须按
+**不互通**设计，分别保存凭据，不能把国内 key 自动发送到国际端点或反向尝试。
+
+当前仓库 `providerPresets.ts` 的 `bigmodel` 使用国内 Base URL 与国内 Key 页面，现有用户配置、
+凭据和模型调用都属于 `cn` profile。此前文档标题把 BigModel / Z.AI 并列写在一起，容易误读为
+现有预设使用国际站，本轮已纠正；不得把存量 `bigmodel` 默认端点改成国际域名。
+
+国内 `glm-5.3` 另外确认以下协议，Flash 不能从它外推：
+
+| 协议 | 国内 Base URL | 已确认模型范围 |
+|---|---|---|
+| OpenAI Responses | `https://open.bigmodel.cn/api/v1` | `glm-5.3`；Flash 模型页未列出 |
+| Anthropic Messages | `https://open.bigmodel.cn/api/anthropic` | `glm-5.3`；Flash 模型页未列出 |
+
+`glm-5.3-flash` 官方模型页只链接 `POST /paas/v4/chat/completions`，本项目只能把
+Chat Completions 视为已确认协议，不能因同一供应商的 `glm-5.3` 支持另外两种协议而外推。
+
+**账号限制**：订阅过 GLM Coding Plan（含已过期）的账号，官方文档写明暂时只能通过
+Chat Completions 调用模型 API。同一账号在不同协议上的可用性可能不同。
+
+## 3. 模型清单
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 / 最大输出 | 国内标准价（CNY/M tokens） | 国际标准价（USD/M tokens） |
+|---|---|---|---|---|---|
+| `glm-5.3` | 最新旗舰文本模型，面向软件工程与 Agent 任务 | 文本 → 文本 | 1M / 128K | 输入 8；输出 28；缓存命中 2 | 见国际价格页，发布前核对 |
+| `glm-5.3-flash` | GLM-5 系列首个原生多模态模型；2026-08-26 上线 | 文本、图片、视频、文件 → 文本 | 1M / 128K | 输入 0.8；输出 2.8；缓存命中 0.23 | 输入 0.15；输出 0.50；缓存命中 0.03 |
+| `glm-5v-turbo` | 面向看图、看视频写代码的多模态 Coding 基座 | 文本、图片、视频、文件 → 文本 | 200K / 128K | 官方模型页未直接列出，发布前重新查价格页 | 是否在国际站提供及价格未在本轮核对 |
+
+2026-08-28 价格页对 `glm-5.3-flash` 显示“5 折限时两周”：输入 0.4、输出 1.4、
+缓存命中 0.115 元/百万 tokens，缓存存储限时免费。页面没有显示促销开始日或绝对结束日，
+所以这里把划线前价格记录为标准价，促销价只作为带核对日期的动态事实，发布或展示前必须重新核对。
+
+`glm-5.3-flash` 的模型页还写明 API 价格为 `glm-5.3` 的 1/10、限时价格为 1/20；
+与价格页上述数值一致。Coding Plan 中按 3 倍用量扣减属于订阅额度规则，不是 API token 单价。
+
+国际价格页显示 2026-08-28 的 5 折价为输入 $0.075、输出 $0.25、缓存命中 $0.015 / M tokens，
+并明确促销至 2026-09-09 24:00（UTC+8，新加坡时间）。国内页面只写“限时两周”，没有绝对日期；
+两区价格必须随 endpoint profile 展示，不能换算后合并成一个计价真相。
+
+## 4. `glm-5.3-flash` 输入契约
+
+### 4.1 通用请求
+
+- 端点：`POST /paas/v4/chat/completions`。
+- `messages[].content` 可以是文本字符串，或多模态内容块数组。
+- 输出仅为文本；公开模型页没有声明音频输入，不能因对话端点的通用 schema 含音频类型就给本模型登记音频能力。
+- 推荐参数：`temperature: 1`、`top_p: 0.95`、`reasoning_effort: "max"`、
+  `thinking: {"type":"enabled"}`。官方建议不要同时调整 `temperature` 与 `top_p`。
+- `max_tokens` 最大 131072，官方建议不低于 1024。
+- `stop` 最多 4 个字符串。
+
+### 4.2 图片
+
+- 内容块为 `{"type":"image_url","image_url":{"url":"..."}}`。
+- 支持公网 URL 或 Base64 Data URL；每张小于 5 MB，最大 6000×6000，格式为 JPG/PNG/JPEG，
+  最多 50 张。
+- SDK 与宿主必须继续遵守媒体上传约束：消费界面不得提供手动 URL 文本框；URL/Base64 由媒体选择、
+  上传或宿主转换链路产生。
+
+### 4.3 视频
+
+- 内容块为 `{"type":"video_url","video_url":{"url":"..."}}`。
+- 官方 Chat 示例确认公网 URL；文件不超过 200 MB，格式为 MP4/MKV/MOV。
+- 官方页面没有给出本模型的视频时长上限，也没有给出视频 Base64 写法，均保持未知，不得猜测。
+
+### 4.4 文件
+
+- 推荐内容块类型是 `file`；旧 `file_url` 仍可用但官方标记为不推荐。
+- `file` 中 `file_id`、`file_url`、`file_data` 三选一；单文件最大 50 MB，最多 50 个文件。
+- `file_data` 是带 MIME 的 Base64 Data URL；`file_url` 页面列举 PDF/TXT/Word/JSONL/XLSX/PPTX 等。
+- 官方 Chat 文档说 `file_id` 由文件上传接口取得，但文件上传接口的公开 `purpose` 仅列
+  `batch`、`code-interpreter`、`agent`、`voice-clone-input`，没有 Chat 用途。13.2 不得猜一个
+  `purpose`；这个分支必须等官方补充或经授权的真实请求验证。
+
+公开资料没有说明图片、视频、文件能否跨模态混合，也没有给出混合后的总数量/体积上限；
+不要套用 `glm-5v-turbo`“三者不能同时理解”的限制，也不要反向假定 Flash 一定支持任意混合。
+
+## 5. 思考模式与工具调用
+
+- `glm-5.3` 与 `glm-5.3-flash` 都是强制思考模型，`thinking.type` 只能是 `enabled`。
+- `reasoning_effort` 支持 `low` / `high` / `max`，默认 `max`。
+- 官方对标准 API 建议显式传 `thinking.clear_thinking: false` 保留跨轮思考；Coding Plan 默认保留，
+  标准 API 默认清除。现有项目仅有供应商级思考映射，13.2 需要先确认如何只对需要的模型下发，
+  不能无差别改变同供应商旧模型。
+- Function Calling 已确认；工具最多 128 个，`tool_choice` 的公开说明只给出 `auto`，不要显式发送
+  其他取值。工具由宿主执行，再以 `role: "tool"` 与 `tool_call_id` 回传。
+- 交错思考的多轮工具调用必须把上一轮完整、原序的 `reasoning_content` 与工具调用一起回传；
+  不得只保留可见文本。
+
+模型页建议流式工具调用时同时传 `stream: true` 与 `tool_stream: true`，但对话 OpenAPI 的视觉请求
+schema 未暴露 `tool_stream`，通用字段说明列出的支持模型也未包含 `glm-5.3-flash`。基础工具调用已确认，
+专有的 `tool_stream` 优化暂不可登记为稳定能力，见第 9 节。
+
+## 6. Chat Completions 事件契约矩阵
+
+下表区分官方 schema 的可空性与项目解析策略。官方没有给某些字段标 `required` 时保持 optional，
+不能把示例中“恰好存在”提升为协议必填。
+
+| 事件 / 响应 | 前置状态 | required / optional / nullable | 空值与缺字段语义 | 状态迁移、输出与副作用 | 终态 / 连接 |
+|---|---|---|---|---|---|
+| 非流式 HTTP 成功 | 请求已发送 | 响应对象包含 `choices`；`message.content` 在工具调用时可为 `null`；`reasoning_content`、`tool_calls`、`usage` 按场景可选 | 工具调用时无文本是合法响应，不能报“结果无文本” | 发出非空文本/思考，收集工具调用与 usage | 单次 HTTP 终态，响应消费后释放 |
+| SSE 普通增量 | 流已建立、尚未终止 | `choices` 可能缺失或为空；`delta.content`、`delta.reasoning_content`、`delta.tool_calls` 均可选，content 可为 `null` 或空串 | 无 choice/空内容块合法，忽略而不是制造 token | 非空文本/思考按序追加；工具参数按 `index` 拼接 | 非终态，保持连接 |
+| SSE 工具增量 | 流已建立、工具参数未完成 | `delta.tool_calls[]` 分片含 `index`；`id`、函数名、arguments 会分块出现 | 单片不完整合法，不能逐片解析完整 JSON | 按 index 保留顺序并拼接；本事件不执行工具 | 非终态，保持连接 |
+| SSE 完成块 | 已有零到多个增量 | `finish_reason` 只在最终块出现；`delta.content` 可为空；`usage` 通常只在最终块出现 | “空文本 + finish_reason + usage”是合法终态；无有效文本但有工具调用同样合法 | 保存开放字符串形式的 finish reason 与 usage，不额外发空 token | 语义终态，但仍应消费 `[DONE]` |
+| `data: [DONE]` | 最终块之后，或供应商直接终止 | 非 JSON 哨兵 | 不解析为对象 | 停止读取并释放 reader/连接 | 流终态 |
+| HTTP 错误 | 请求被端点拒绝 | 官方错误对象含 `error.code` 与 `error.message` | 不应把错误正文当增量事件 | 转换为脱敏 SDK 错误，保留状态码与可诊断代码 | 终态，释放响应 |
+| 中途断线 / Abort / timeout | 流已建立 | 官方没有定义专用恢复事件 | 不能把断线当 `[DONE]` 或成功终态 | 传播取消/超时/网络错误，停止工具副作用 | 终态；是否连接复用未由官方说明，宿主必须释放 |
+| 工具结果续轮 | 上一轮 `finish_reason=tool_calls` | assistant 历史需保留完整 `reasoning_content`、`tool_calls`；工具消息需 `tool_call_id` | 丢掉思考或工具 id 会破坏后续推理 | 宿主执行工具，把结果作为新消息发起下一次请求 | 新 HTTP/SSE 会话，不是旧连接复用 |
+
+官方流式示例还显示：最终增量可只有空 `content`、`finish_reason` 与 usage，随后再发 `[DONE]`；
+官方 SDK 示例会先判断 `choices` 是否为空再读取。因此合法空块、无 choices 块必须进入 fixture 和解析测试。
+
+`finish_reason` 的 schema 枚举列出 `stop`、`length`、`tool_calls`、`sensitive`、`network_error`，
+但同页字段说明还提到 `model_context_window_exceeded`。这是官方页面内部不一致；解析器必须接受并保留
+未知字符串，不能用封闭枚举拒绝服务器返回。
+
+## 7. 结构化输出与流式能力
+
+- 普通文本流式已确认：SSE `data:` JSON 帧、最终 `finish_reason`/usage、`data: [DONE]`。
+- 思考过程通过增量 `reasoning_content` 返回。
+- 模型页声称支持结构化输出，但视觉请求 OpenAPI 未暴露 `response_format`，通用字段说明又写
+  “仅文本模型支持”。在官方澄清前，13.2 必须保守登记为不支持结构化输出，不能宣称 JSON schema。
+- 模型页建议 `tool_stream: true`，但 API schema 的模型支持清单未包含本模型；基础流式和基础工具调用
+  不受此冲突影响，只有 `tool_stream` 专有优化被阻断。
+
+## 8. 联网搜索
+
+智谱有三套不同产品，不要混为一谈：
+
+| 产品 | 调用方式 | 边界 |
+|---|---|---|
+| Web Search API | `POST /paas/v4/web_search` | 独立检索端点，拿结构化结果后由宿主拼入 prompt |
+| Chat Completions 网络搜索工具 | `tools[].type = "web_search"`，另带 `web_search` 嵌套配置 | 让模型结合搜索结果作答；不是 OpenAI 扁平工具 schema |
+| Search Agent | Assistant API 的 `assistant.conversation()` | 更重的调研式工作流，不属于普通 Chat 工具 |
+
+搜索引擎价格：`search_std` ¥0.01/次、`search_pro` ¥0.03/次、
+`search_pro_sogou` / `search_pro_quark` ¥0.05/次。搜索是独立计费工具，不含在模型 token 单价中。
+
+## 9. 未决项与 13.2 编码门槛
+
+按“官方资料先行”规则，当前**不可按完整能力进入 13.2 编码**。若 13.2 接受保守降级，
+可只实现已经确认的子集；否则必须先取得官方澄清或用户授权真实请求验证：
+
+| 未决项 | 官方冲突 / 缺口 | 13.2 保守边界 |
+|---|---|---|
+| 结构化输出 | 模型页称支持；Vision OpenAPI 不含 `response_format`，通用说明称仅文本模型支持 | `structuredOutputMode: none`，不得发送 `response_format` |
+| `tool_stream` | 模型页建议开启；OpenAPI Vision schema 缺字段，通用支持模型清单缺 Flash | 只支持普通 Function Calling；不发送 `tool_stream` |
+| `file_id` 上传 | Chat 接口允许 `file_id`，上传接口 `purpose` 无 Chat 枚举 | 不实现/不测试 `file_id`；若扩文件能力只能先走官方明确的 `file_url`/`file_data`，且继续遵守宿主上传与无 URL 文本框规则 |
+| 跨模态混合 | 未说明图片/视频/文件能否混合及总量限制 | 不承诺混合；测试和 UI 不自动开放任意组合 |
+| 模型专属流式样本 | 官方字面 SSE/工具流样本使用 `glm-5.2`/`glm-5.3`，不是 Flash | 可作为“同端点官方相关模型样本”验证通用 parser，不能冒充 Flash 专属 fixture；模型专属事件正确性仍需官方样本或授权真网 |
+
+## 10. 13.2 精确代码与测试输入
+
+确认采用上表保守边界后，13.2 至少需要检查并改动：
+
+- `packages/ai-sdk/src/llm/modelCatalogEntries.ts`：新增独立 `glm-5.3-flash` 条目；
+  `image=true`、`video=true`、`audio=false`，1M / 128K；结构化输出保持保守值。
+- `packages/ai-sdk/src/llm/providerPresets.ts`：现有 `bigmodel` 国内 preset 保持原 Base URL 与凭据不变；
+  新增同一供应商族的 `cn` / `global` endpoint profile 数据，国际 profile 使用 Z.AI Base URL 和 Key 页面。
+- `packages/ai-sdk/src/llm/types.ts`：补供应商族、endpoint profile 与 credential identity；不要用模型 ID
+  或 UI 条件分支判断区域。
+- 凭据：当前 SDK 用 `credentials.get('llm', providerId)`，Electron keystore 也按 providerId 存取。
+  13.2 必须让国内/国际配置实例使用不同凭据槽；国内存量 `bigmodel` 原槽原值保留并默认 profile=cn。
+- `packages/ai-sdk/src/llm/providerReasoningRequest.ts`：现有 `bigmodel` 是供应商级规则；需要模型感知后再决定
+  `thinking.clear_thinking=false`，不得为 Flash 修改而误伤 `glm-5v-turbo`。
+- `packages/ai-sdk/src/llm/streaming.ts` 与 `packages/ai-sdk/src/llm/chatTypes.ts`：核对工具调用增量、
+  无 choices/合法空块、finish reason 开放字符串与 reasoning 保留；当前文本 parser 不能被模型目录登记替代。
+- `packages/ai-sdk/src/llm/sdk/provider.ts` 及模型步骤输入转换：确认 image/video 在两个正式消费路径的真实能力；
+  智能助手路径当前不支持视频，目录与 UI 不得静默宣称全路径可用。
+- 文件输入若进入范围，先扩统一 LLM 输入种类、宿主 media/upload 接口与安全边界；不能在 UI 添加 URL 文本框，
+  也不能仅为 Flash 写专属旁路。
+- fixture：逐项保存官方 Flash 图片、视频、文件字面请求；通用 SSE/工具流样本必须标注实际示例模型 ID。
+- 精确测试：目录/预设/思考请求、多模态序列化、合法空 SSE、无 choices、空终态、无有效 final、
+  工具参数分块、重复/乱序、错误、Abort/timeout/断线与资源释放，并执行断牙验证。
+
+## 官方来源索引
+
+以下页面均于 2026-08-28 核对：
+
+- [GLM-5.3-Flash 模型说明](https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash)（用户指定来源；模型 ID、模态、上下文、参数、能力与相对价格）
+- [新模型发布记录](https://docs.bigmodel.cn/cn/update/new-releases)（2026-08-26 上线日期）
+- [模型总览](https://docs.bigmodel.cn/cn/guide/start/model-overview)（模型定位、上下文、最大输出与价格入口）
+- [对话补全 API](https://docs.bigmodel.cn/api-reference/模型-api/对话补全)（端点、请求/响应 schema、Flash 多模态字面示例与限制）
+- [流式输出](https://docs.bigmodel.cn/cn/guide/capabilities/streaming)（SSE、空最终块、usage 与 `[DONE]`）
+- [流式工具调用](https://docs.bigmodel.cn/cn/guide/capabilities/stream-tool)（工具参数分块、`tool_stream` 与宿主续轮）
+- [Function Calling](https://docs.bigmodel.cn/cn/guide/capabilities/function-calling)（工具声明、执行与 `tool_call_id`）
+- [思考模式](https://docs.bigmodel.cn/cn/guide/capabilities/thinking-mode)（强制思考、交错思考与 `clear_thinking`）
+- [文件上传 API](https://docs.bigmodel.cn/api-reference/文件-api/上传文件)（上传端点与 purpose 缺口）
+- [错误码](https://docs.bigmodel.cn/cn/faq/api-code)（认证、限流、参数、内容安全与服务错误）
+- [智谱模型价格](https://open.bigmodel.cn/pricing)（标准价与 2026-08-28 可见的限时价）
+- [智谱文档全量索引](https://docs.bigmodel.cn/llms.txt)（相关页面发现与交叉核对）
+- [GLM-5.3 模型说明](https://docs.bigmodel.cn/cn/guide/models/text/glm-5.3)
+- [GLM-5V-Turbo 模型说明](https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5v-turbo)
+- [联网搜索](https://docs.bigmodel.cn/cn/guide/tools/web-search)
+- [国内 Quick Start](https://docs.bigmodel.cn/cn/guide/start/quick-start)（国内 Base URL、Key 管理入口与 Flash）
+- [国际 GLM-5.3-Flash](https://docs.z.ai/guides/vlm/glm-5.3-flash)（国际站模型身份、模态与参数）
+- [国际 Quick Start](https://docs.z.ai/guides/overview/quick-start)（国际 Base URL、Key 管理入口与 Flash）
+- [国际 HTTP API](https://docs.z.ai/guides/develop/http/introduction)（国际通用端点与 Bearer 鉴权）
+- [国际价格](https://docs.z.ai/guides/overview/pricing)（USD 标准/促销价与截止时间）
+- [国际文档索引](https://docs.z.ai/llms.txt)（国际站页面覆盖）

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//347/201/253/345/261/261/345/274/225/346/223/216.md

@@ -0,0 +1,87 @@
+# 火山引擎（Doubao / Ark 方舟）
+
+> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录（部分页面需要用浏览器打开，SPA 内容 curl 拿不到，见文档采集手册）。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `volcengine` / `ark` |
+| 对应项目 `adapter` | `openai`（Chat Completions）；官方还提供 Responses API |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 目录内三款模型已默认走 **Responses API**；Chat Completions 保留兼容，官方没有 Anthropic Messages API |
+| 鉴权 | `Authorization: Bearer $ARK_API_KEY` |
+| Base URL | `https://ark.cn-beijing.volces.com/api/v3`（区域相关，其余区域见控制台） |
+| 官方协议 | Chat Completions（`/chat/completions`）与 Responses API（`/responses`）**并行维护**，新模型同步支持两者 |
+
+## 2. 模型清单
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 / 最大输入 | 最大思维链 / 最大输出 | RPM / TPM |
+|---|---|---|---|---|---|
+| `doubao-seed-evolving` | 面向 Agent/Coding 的持续升级模型，**Model ID 固定、版本自动滚动**，无需迁移即可拿到新能力 | 文本、图片、视频 → 文本 | 1024K / 1024K | 256K / 256K | 500 / 1,000,000 |
+| `doubao-seed-2-1-pro-260628` | Seed 2.1 高复杂度任务版本 | 文本、图片、视频 → 文本 | 256K / 256K | 256K / 256K | 500 / 1,000,000 |
+| `doubao-seed-2-1-turbo-260628` | Seed 2.1 规模化、成本更友好版本 | 文本、图片、视频 → 文本 | 256K / 256K | 256K / 256K | 500 / 1,000,000 |
+
+价格（元/百万 tokens，常规在线推理档）：
+
+| 模型 | 输入 | 缓存命中 | 缓存存储 | 输出 |
+|---|---|---|---|---|
+| `doubao-seed-evolving` | 6.00 | 1.20 | 0.017/小时 | 30.00 |
+| `doubao-seed-2-1-pro` | 6.00 | 1.20 | 0.017/小时 | 30.00 |
+| `doubao-seed-2-1-turbo` | 3.00 | 0.60 | 0.017/小时 | 15.00 |
+
+批量推理（Batch）：Pro 输入 3.00/输出 15.00，Turbo 输入 1.50/输出 7.50（均半价）。低延迟档 Turbo 价格与 Pro 常规档相同（6.00/1.20/30.00）——**低延迟不等于更贵的 Pro**，是 Turbo 的一个独立计价维度，选型时不要按模型名猜价格。
+
+`doubao-1-5-pro-32k-character-250715` **不支持** Responses API（官方原文标注的唯一例外），其余 250615 及之后版本的大语言模型默认都支持。
+
+## 3. 思考模式
+
+- 深度思考默认开启，用 `thinking` 参数控制开关。
+- `reasoning_effort` 支持 **7 档**：`none`/`minimal`/`low`/`medium`/`high`/`xhigh`/`max`，默认 `high`。（此前整理的资料只列了 4 档，遗漏了 `none`/`xhigh`/`max`。）
+- 思考内容默认只返回**摘要**（thinking summary）+ 加密原文，不返回原始思维链；多轮对话建议全量回传加密原文，服务端会按场景判断是否丢弃：
+  - Chat API：回传 `encrypted_content` 字段。
+  - Responses API：用 `previous_response_id` 引用上一轮响应即可，不需要手动回传思考内容。
+
+## 4. Chat API vs Responses API——字段级差异（接入 Responses 前必读）
+
+| 维度 | Chat API | Responses API |
+|---|---|---|
+| 输入 | `messages` 数组，无状态，每轮自己拼全部历史 | `input` 可以是字符串或数组；`instructions` 字段可在某一轮临时插入 system 提示 |
+| 多轮管理 | 手动维护 `messages` | 默认开启存储，`previous_response_id` 引用上一轮，服务端管理上下文 |
+| 结构化输出 | `response_format` | `text.format` |
+| 最大输出长度 | `max_completion_tokens` | `max_output_tokens` |
+| 工具定义 | `{"type":"function","function":{"name":...,"parameters":...}}`（嵌套） | `{"type":"function","name":...,"parameters":...}`（**扁平，`name`/`parameters` 提到外层**） |
+| 上下文缓存 | 隐式缓存（自动，不保证命中） | 隐式缓存 + **显式缓存**（`caching:{"type":"enabled"}`，ID 粒度更灵活） |
+
+**内置工具（联网搜索、图像处理、私域知识库搜索、云部署 MCP）只有 Responses API 能用，Chat API 完全不支持**——这是选择要不要接 Responses API 的最直接理由。
+
+## 5. 内置工具（均只在 Responses API 可用）
+
+| 工具 | `tools` 声明 | 备注 |
+|---|---|---|
+| 联网搜索 Web Search | `{"type":"web_search","max_keyword":2}` | 通过 Responses API 使用时**不推荐 `doubao-seed-1-6-flash`** |
+| 图像处理 Image Process | `{"type":"image_process","zoom":{"type":"enabled"},...}` | 需要额外 Header `ark-beta-image-process: true`，支持画点/画线/旋转/缩放/裁剪 |
+| 私域知识库搜索 Knowledge Search | `{"type":"knowledge_search","knowledge_resource_id":...}` | 需要额外 Header `ark-beta-knowledge-search: true`，仅支持旗舰版知识库 |
+| 云部署 MCP | `{"type":"mcp","server_label":...,"server_url":...}` | 对接 MCP MarketPlace，需要 Header `ark-beta-mcp: true` |
+
+这些工具都要求额外的 `default_headers`/`extra_headers` 才能生效，不是单纯在 `tools` 里声明就够——遗漏 Header 大概率是"请求成功但工具没触发"的静默失效，而不是报错。
+
+## 6. 图片理解精细度
+
+`detail` 参数：`low`（token [1,1280]，像素 [1764, 2257920]）/ `high`（固定 1280 token，默认值）/ `xhigh`（token [1280,5120]，像素 [2257920, 9031680]）。图片/视频/文档超过 10MB 建议用 Files API 先上传拿 File ID，不要直接塞 base64。
+
+## 7. 与「豆包搜索」的区别（避免混淆）
+
+火山引擎还有一个独立消费产品叫「豆包搜索」，是 **Agent Plan 套餐**（编程 IDE/Agent 场景）的联网搜索订阅服务，通过 Skill/MCP 接入 Claude Code、OpenCode 等三方工具，跟本文档说的 Responses API `web_search` 内置工具**不是同一套东西**——前者是终端用户在 IDE 里用的订阅制服务，后者是纯 API 调用参数。本项目走 API 集成，不涉及豆包搜索。
+
+## 原始链接索引（均无需登录；SPA 页面用浏览器打开，见采集手册）
+
+- [Doubao-Seed-Evolving 模型详情](https://docs.volcengine.com/docs/82379/2549861)
+- [模型列表](https://docs.volcengine.com/docs/82379/1330310)
+- [模型价格](https://docs.volcengine.com/docs/82379/1544106)
+- [使用 Responses API（基础差异对照）](https://docs.volcengine.com/docs/82379/1585128)
+- [Responses API 文本生成](https://docs.volcengine.com/docs/82379/1958520)
+- [Responses API 深度思考](https://docs.volcengine.com/docs/82379/1956279)
+- [Responses API 多模态理解](https://docs.volcengine.com/docs/82379/1958521)
+- [Responses API 结构化输出(beta)](https://docs.volcengine.com/docs/82379/1958523)
+- [工具调用（内置工具汇总）](https://docs.volcengine.com/docs/82379/1958524)
+- [豆包搜索（Agent Plan 订阅服务，仅供区分参考）](https://docs.volcengine.com/docs/82379/2301412)

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

@@ -0,0 +1,84 @@
+# 阿里云百炼 / Qwen
+
+> 核对时间：2026-08-26。信息来源见文末「原始链接索引」。**控制台模型详情页（`bailian.console.aliyun.com`）需要登录**，实测自动化浏览器访问会被拦截（`请求失败，请检查网络设置`）；本文档内容全部来自 `help.aliyun.com` 的公开文档页，未登录也能完整核对协议、模型清单与价格。仅当需要交互式"体验中心"截图或账号级用量数据时才必须登录控制台。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `bailian` / `dashscope` |
+| 对应项目 `adapter` | `openai`（Chat Completions）；官方也提供 Responses API |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | Qwen3.8-Max 已默认走 **Responses API**；Chat Completions 保留兼容，官方没有 Anthropic Messages API |
+| 鉴权 | `Authorization: Bearer $DASHSCOPE_API_KEY` |
+| Base URL | `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`（**地域相关，`{WorkspaceId}` 和区域后缀需要从控制台"查看代码"复制当前值，不要硬编码**） |
+| 官方协议 | OpenAI Chat Completions（`/chat/completions`）+ OpenAI Responses API（`/responses`），同一 Base URL 下两个路径 |
+
+## 2. 模型：`qwen3.8-max`
+
+千问最新旗舰 MoE 模型，强化编程、办公、原生视觉理解、超长文档与长视频能力。
+
+**关键适配陷阱**：`qwen3.8-max` 必须使用**多模态接口**格式发送消息，不能用给纯文本模型（如 `qwen-plus`）准备的简单文本接口——官方原文警告"直接替换模型会导致 `url error` 错误"。也就是说即便请求内容是纯文字对话，`qwen3.8-max` 的 `content` 字段也要按多模态消息数组的形式组织（`[{"type":"text","text":"..."}]`），不能直接传字符串。这是从"模型能力标注含图片/视频"这句话本身看不出来的隐藏约束，写 `request.builder()` 时必须按多模态 schema 走。
+
+同样要求多模态接口的还有：`qwen3.8-27b`、`qwen3.7-max-2026-06-08`、Qwen3.6/Qwen3.5 系列；仅需纯文本接口的是：`qwen3.8-2.4t-a95b`、`qwen3.7-max`、`qwen3.7-max-2026-05-20`、`qwen3.6-max-preview`。两类接口不能混用模型 ID。
+
+### 价格（元/百万 tokens，`0 < Token ≤ 1M`，服务部署范围"全球"）
+
+| 模型 ID | 输入 | 输出（思维链+回答） | 免费额度 |
+|---|---|---|---|
+| `qwen3.8-max` | 12 | 36 | 100 万 Token（有效期 90 天） |
+| `qwen3.8-max-prime`（优速模式 Prime） | 24 | 72 | 无免费额度 |
+
+`qwen3.8-max-prime` 是此前资料遗漏的一个变体——"优速模式"，价格是标准版的整整 2 倍，用于对延迟更敏感的场景，属于同一发布线下的独立计价档位，接入时应作为一个可选的产品级参数（渠道/模式）而不是隐藏细节。
+
+国际（`国际`）与欧盟区域价格更高（`qwen3.8-max` 国际区 14.988/44.965 元），实际扣费以当前请求命中的区域为准；Batch 调用半价，上下文缓存命中享折扣（具体折扣比例见 [上下文缓存文档](https://help.aliyun.com/document_detail/2862577.html)）。
+
+## 3. Responses API 接入示例
+
+```python
+client = OpenAI(api_key=..., base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1")
+response = client.responses.create(model="qwen3.8-max", input="简要介绍下你能做什么？")
+```
+
+- 返回结构里 `output` 数组包含 `reasoning`（仅思考模式开启时出现）和 `message`。
+- **已知限制**：Responses API 路径**不支持** `enable_source`/`enable_citation`/`citation_format` 参数，不会在回复正文里自动插入 `[1]` 角标引用——如果产品需要角标标注，只能退回传统 DashScope 原生调用方式，不能靠 Responses API 实现。
+
+## 4. 思考模式
+
+用 `extra_body={"enable_thinking": true}`（Chat Completions/Responses 均适用）控制是否开启深度思考；官方没有像 GLM/Kimi 那样给出离散的 `reasoning_effort` 档位字符串，是布尔开关而非强度分级。
+
+## 5. 联网搜索与内置工具
+
+Responses API 下可以在 `tools` 数组里组合声明三个内置工具，模型自主决定调不调用：
+
+```python
+response = client.responses.create(
+    model="qwen3.8-max",
+    input="杭州天气",
+    tools=[
+        {"type": "web_search"},
+        {"type": "web_extractor"},
+        {"type": "code_interpreter"},
+    ],
+    extra_body={"enable_thinking": True},
+)
+```
+
+- `web_search`：联网搜索，价格 4 元/1,000 次。
+- `web_extractor`：网页正文抓取，官方页面标注限时免费。
+- `code_interpreter`：代码解释器，官方页面标注限时免费。
+- 搜索来源在响应 `output` 数组里 `type=web_search_call` 的元素、其 `action.sources` 字段里，不在正文文本中自动标注引用。
+- **Chat Completions 路径的等价用法更简单**：直接传 `enable_search: true`（布尔值），不需要声明完整的 `tools` 数组，但拿不到 `web_extractor`/`code_interpreter` 这类独立工具，只有联网搜索一项。两条路径的联网搜索能力不完全对等，接入时要按实际选的协议决定暴露哪种开关。
+
+## 6. 与其它供应商在百炼上共存（了解即可，不改变本文档定位）
+
+百炼控制台除了阿里自有的 Qwen 系列，还以"三方直供"名义上架了 Kimi K3、智谱 GLM-5.3、MiniMax-M3、`mimo-v2.5-pro` 等——即这几家供应商也可以通过百炼这个统一入口调用。本项目的供应商划分以官方原生 API 为准（各自单独一份文档），百炼上的"三方直供"版本只是同一模型的另一个接入口，不单独维护文档，只在这里作为背景记录。
+
+## 原始链接索引
+
+- [模型概览（含所有可用模型清单）](https://help.aliyun.com/zh/model-studio/models) — 无需登录
+- [文本生成（含 Chat Completions/Responses 双协议代码示例、多模态接口区分表）](https://help.aliyun.com/zh/model-studio/text-generation) — 无需登录
+- [联网搜索工具](https://help.aliyun.com/zh/model-studio/web-search) — 无需登录
+- [模型价格](https://help.aliyun.com/zh/model-studio/model-pricing) — 无需登录
+- [Qwen 使用指南](https://help.aliyun.com/zh/model-studio/user-guide/qwen) — 无需登录
+- [OpenAI 兼容-Responses（完整迁移指南）](https://help.aliyun.com/document_detail/3016539.html) — 无需登录
+- 百炼控制台模型详情页（`bailian.console.aliyun.com/.../model-market/detail/qwen3.8-max`）—— **需要登录**，自动化访问被拦截；需要交互式体验或账号级信息时再手动登录查看

package/docs/llm-adaptation//346/226/207/346/241/243/351/207/207/351/233/206/346/211/213/345/206/214.md

@@ -0,0 +1,88 @@
+# 文档采集手册（LLM 供应商）
+
+> 这份手册只记 LLM 供应商调研中**做过一遍才知道**的东西，是 [docs/model-adaptation/文档采集手册.md](../model-adaptation/文档采集手册.md) 方法论在 LLM 场景下的落地版本；通用方法（`.md` 后缀技巧、SPA 找内容 API、交叉校验）不重复抄写，只记这里特有的坑。
+> 最后更新：2026-08-26（基于 7 家 LLM 供应商的实际采集）
+
+## 一、大多数 LLM 文档站是 Mintlify，`.md` 后缀直接返回原文
+
+`platform.kimi.com`、`docs.bigmodel.cn`、`platform.minimaxi.com`、`api-docs.deepseek.com`（部分页面）在 URL 末尾加 `.md` 都能拿到干净的 Markdown 原文，且首行会自带一条 `llms.txt` 全量索引提示：
+
+```bash
+curl -sL "https://platform.kimi.com/docs/guide/kimi-k3-quickstart.md"
+curl -sL "https://docs.bigmodel.cn/cn/guide/models/text/glm-5.3.md"
+curl -sL "https://platform.minimaxi.com/docs/guides/server-tools.md"
+```
+
+先抓 `<域名>/docs/llms.txt`（Kimi/MiniMax/智谱都有），按关键词过滤出目标模型的全部页面——LLM 供应商的文档比生成模型供应商更"碎"，同一个模型的思考参数、联网搜索、工具调用、定价往往各自独立成页，只看模型主页会漏掉大半细节（例如 Kimi K3 的 `$web_search` 用法、固定采样参数、视觉输入必须 base64 这几条，全部在主页之外的独立页面）。
+
+## 二、Docusaurus 站点（DeepSeek）：先查 sitemap，不要猜 locale 前缀
+
+`api-docs.deepseek.com` 是 Docusaurus，**不支持** `.md` 后缀（会静默 fallback 到别的页面，返回 200 但内容驴唇不对马嘴），也没有 `/zh-cn/` 中文前缀可用（那是根据浏览器语言自动切换的，服务端 sitemap 里只有不带前缀的英文路径）：
+
+```bash
+curl -sL "https://api-docs.deepseek.com/sitemap.xml" | grep -oE "<loc>[^<]+</loc>"
+```
+
+抓到真实 URL 列表后直接 curl 拿完整 SSR HTML，配合下面的 HTML 转文本脚本提取正文，不要在浏览器里跟折叠 UI 搏斗。
+
+```python
+# strip_html.py 核心思路：用 HTMLParser 只保留 article / .theme-doc-markdown 容器内的文本，
+# pre/code 块保留反引号和代码围栏，跳过 script/style/nav/header/footer。
+# 完整实现见本次调研留档，或按需重写——逻辑不复杂，不必依赖第三方库。
+```
+
+## 三、Volcengine 方舟文档：内容 API 对新版块（Responses API）会"假成功、真空"
+
+`docs.volcengine.com/api/doc/getDocDetail?LibraryID=82379&DocumentID=<id>&type=online` 对大多数页面能直接拿到 `Result.MDContent`，但**对"进阶使用 → 使用 Responses API"这个分类节点本身**，接口返回 200 且结构完整，`Result` 却是空的——包括在浏览器里发同一个请求也是空，不是登录墙，是这类"目录节点"本身没有正文，真正的内容在它的子页面。
+
+排查方法：用浏览器打开该节点对应的 `docs.volcengine.com/docs/82379/<id>` 页面，`read_page(filter: interactive)` 读出左侧导航栏里子项的 `href`，从 `href` 里拿到真实子页面的 `DocumentID`，再逐个用内容 API 拉取：
+
+```
+Responses API（父节点，内容为空）[1956278]
+├─ 迁移至 Responses API   [1585128]
+├─ 文本生成                [1958520]
+├─ 深度思考                [1956279]
+├─ 多模态理解              [1958521]
+├─ 工具调用                [1958524]
+└─ 结构化输出(beta)        [1958523]
+```
+
+`getDocList?DataSchema=all_second_nav` 拿到的目录树里能看到这些 DocumentID 和 `ParentID` 关系，但父子内容的可用性不能只看目录结构猜，要么试抓一次，要么直接进浏览器看子项链接。
+
+## 四、纯 SPA 站点（MiMo）：`.md` 后缀无效，必须用浏览器渲染取 `innerText`
+
+`mimo.mi.com` 是纯客户端渲染的 SPA（Vite/React 之类），不管加不加 `.md` 后缀，curl 拿到的都是同一份 index.html 外壳（`<title>Xiaomi MiMo Home</title>`，几百字节的 meta 标签，没有正文）。判断方法：`curl` 到的内容不含目标关键词、且多个不同路径返回**完全相同的字节数**，基本可以确认是 SPA 落到了同一个 fallback 页。
+
+处理方式：
+
+1. 用浏览器打开目标 URL，`wait` 2 秒后 `get_page_text` 通常就能拿到渲染后的正文（这个站点用了标准的 `<main>` 容器，抽取效果不错）。
+2. 页面内部导航链接（"Web Search"这类侧边栏项）不一定对应你猜的 URL slug，`read_page` 有时拿不到完整树（返回空），改用 `javascript_tool` 执行 `Array.from(document.querySelectorAll('a')).map(a=>a.href)` 直接把全部 `<a>` 真实 href 枚举出来，比猜路径快得多，且不会漏掉英文/中文双语言路径（MiMo 的英文文档实际路径带 `/docs/en-US/...` 前缀，中文版没有，两者内容深度不同，**英文版信息量明显更全**，优先读英文版）。
+
+## 五、登录墙不代表拿不到数据：先找"控制台之外"的公开镜像
+
+阿里云百炼的模型详情页（`bailian.console.aliyun.com/.../model-market/detail/<model>`）需要登录，自动化浏览器访问会被拦截（`请求失败，请检查网络设置`，不是普通登录跳转，疑似有风控识别自动化指纹）。
+
+**不要止步于此就去问用户登录**——先确认 `help.aliyun.com`（SSR，无需登录）是否已经覆盖了同样信息：
+
+```bash
+curl -sL "https://help.aliyun.com/zh/model-studio/models.md"          # 模型清单
+curl -sL "https://help.aliyun.com/zh/model-studio/text-generation.md" # 协议、Base URL、代码示例
+curl -sL "https://help.aliyun.com/zh/model-studio/model-pricing.md"   # 完整价格表（含控制台看不到的历史档位）
+curl -sL "https://help.aliyun.com/zh/model-studio/web-search.md"      # 联网搜索工具
+```
+
+这次调研里，百炼模型的 Base URL、协议、请求示例、思考模式、联网搜索、完整价格表（含此前遗漏的 `-prime` 优速档）全部从这几个公开页面拿到，控制台页面实际只有"体验中心""账号用量"这类交互功能是必须登录的。**只有确认公开文档站确实覆盖不了、且信息对本次任务是必需的，才应该停下来请用户登录**，不要把"控制台需要登录"直接等同于"这份资料需要登录才能拿到"。
+
+## 六、LLM 供应商的三项高频交叉校验
+
+| 校验 | 为什么 | 这次的实例 |
+|---|---|---|
+| **协议覆盖面**：一份"总览/清单"资料说某供应商"支持 Responses API"，不代表所有模型、所有账号状态都支持 | 官方文档经常在正文里单独标注例外 | GLM-5.3 官方原文写"订阅过 GLM Coding Plan（含已过期）的账号暂时只能走 Chat Completions"；火山方舟官方原文写"`doubao-1-5-pro-32k-character-250715` 不支持 Responses API" |
+| **联网搜索的协议边界**：同一供应商，联网搜索能不能用往往和主协议选择绑定，不能默认"哪个协议都能用" | 服务端工具通常只在部分协议上实现 | 火山方舟联网搜索**只有** Responses API 能用，Chat API 完全不支持；MiMo 联网搜索**只有** Chat Completions 能用，Anthropic 协议不支持；MiniMax 联网搜索 Anthropic + Responses 都支持但纯 Chat Completions 不支持 |
+| **模型是否要求特定请求形态**：官方模型页说"支持图片/视频输入"，不代表能直接套用别的模型的请求 schema | 有的模型要求特定接口/字段结构，用错会直接报错而非降级 | 百炼 `qwen3.8-max` 必须用多模态消息数组格式，套用纯文本模型的字符串 `content` 会报 `url error`；Kimi K3 图片输入必须 base64，传公网 URL 不会报错但模型看不到图 |
+
+**处理原则**：三项校验任何一项没做，接入代码大概率会出现"部分场景能用、部分场景莫名其妙不生效"的问题，且大概率不会在请求阶段报错——LLM 供应商的容错策略普遍是"未知参数静默忽略"而不是"报 400"，比生成模型供应商更难通过报错定位问题，写文档时要把这类边界条件明确列出来，不能只写"支持"二字。
+
+---
+
+相关：[README.md](README.md)（协议矩阵与供应商清单）、[docs/model-adaptation/文档采集手册.md](../model-adaptation/文档采集手册.md)（生成模型侧的通用方法论）

package/docs/model-adaptation/Bria-Eraser/Bria-Eraser_Fal.md

@@ -0,0 +1,32 @@
+# Bria Eraser · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| SDK 模型 ID | `fal-bria-eraser`（可选工具模型，不进入默认 105 目录） |
+| Fal endpoint ID | `fal-ai/bria/eraser` |
+| API 文档 | https://fal.ai/models/fal-ai/bria/eraser/api |
+| 价格 | $0.04/次 |
+| 登录 | 文档与模型页无需登录；调用需要 Fal Key |
+
+## 协议与字段
+
+使用 Fal 队列公共协议，认证、提交、状态与结果读取同 [Fal 供应商文档](../供应商/Fal.md)。
+输出位于 `image.url`。
+
+| 字段 | 约束 | SDK 策略 |
+|---|---|---|
+| `image_url` | 必填，待处理原图 | `image-upload`，Fal CDN 自动上传 |
+| `mask_url` | 必填，二值遮罩 | `image-upload`，Fal CDN 自动上传 |
+| `mask_type` | `manual` / `automatic`，默认 `manual` | Photoshop 遮罩来自用户选区/画笔，固定发送 `manual` |
+| `preserve_alpha` | 可选 | 插件当前未使用，不发送 |
+| `sync_mode` | 可选 | 不发送，统一走队列 |
+
+该模型的统一画像由 schema 派生为图片输入、图片输出、`operation=image-edit`、`feature=erase`；
+模型定义仍为 `type: image`，避免制造新的生成模态或执行协议。
+
+## 原始链接索引
+
+- https://fal.ai/models/fal-ai/bria/eraser/api — endpoint、字段、结果与队列示例。
+- https://fal.ai/models/fal-ai/bria/eraser — 当前 $0.04/次价格。
+- https://fal.ai/docs/documentation/model-apis/inference/queue — Fal 队列公共协议。

package/docs/model-adaptation/Bria-/345/210/233/346/204/217/346/224/276/345/244/247/Bria-/345/210/233/346/204/217/346/224/276/345/244/247_Fal.md

@@ -0,0 +1,31 @@
+# Bria 创意放大（Fal）
+
+## 契约
+
+| 项目 | 内容 |
+|---|---|
+| endpoint ID | `bria/upscale/creative` |
+| 输入 | `image_url`；Fal 有示例默认图，应用仍严格要求用户提供 1 张源图 |
+| 输出 | `image: Image`，约 2×，最高 10MP |
+| 参数 | `preserve_alpha`，默认 true |
+| 隐藏字段 | `seed`、`sync_mode` |
+| 价格 | `$0.04/张` |
+| 资料核查 | 2026-08-29；公开，无需登录 |
+
+## 队列与适配
+
+使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`，复用标准 Fal
+`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED` 队列、取消和 URL 提取。canonical ID 为
+`bria-creative-upscale`，应用模型 ID 为 `fal-ai-bria-creative-upscale`。
+
+画布按固定 2× 预估尺寸，在上传前阻止超过 10MP 的输出；透明源图允许提交并默认保留 alpha。该模型属于
+创意增强，可能生成新纹理，界面不使用“无损”措辞。已完成端点、请求、固定价、alpha 和输出上限的离线测试；
+未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API 文档 | https://fal.ai/models/bria/upscale/creative/api | 否 |
+| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=bria/upscale/creative | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |