@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation/SenseVoiceSmall/SenseVoiceSmall_/347/241/205/345/237/272/346/265/201/345/212/250.md

@@ -1,69 +1,69 @@
-# SenseVoiceSmall · 硅基流动
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-31 |
-| 模态 | ASR（同步文件转写） |
-| 供应商 | SiliconFlow / SiliconCloud |
-| 平台模型 ID | `FunAudioLLM/SenseVoiceSmall` |
-| 当前公开价格 | **免费** |
-| 免费前提 | 账号实名认证；固定 Rate Limits，精确数值未公开 |
-| 文档/价格 | 公开无需登录；Key/实名/用量需登录 |
-
-## 1. 端点与鉴权
-
-```text
-POST https://api.siliconflow.cn/v1/audio/transcriptions
-Authorization: Bearer <SILICONFLOW_API_KEY>
-Content-Type: multipart/form-data
-```
-
-请求仅需两个官方公开字段：
-
-```text
-file=<binary audio file>
-model=FunAudioLLM/SenseVoiceSmall
-```
-
-`file` 必须不超过 1 小时、50 MB。官方 cURL 以 MP3 为示例，但转写页未公开完整文件
-格式白名单。公开协议没有 `language/prompt/response_format`、热词、说话人、情感或音频事件
-参数，也没有 WebSocket/SSE 实时接口。
-
-## 2. 响应契约
-
-```json
-{
-  "text": "<string>"
-}
-```
-
-响应头包含 `x-siliconcloud-trace-id`。虽然 SenseVoice 开源上游还有多语种、情感与音频事件能力，
-硅基流动当前转写 API 只声明 `text`。SDK 文档与类型不得保证端点会返回上游额外标签。
-
-## 3. 价格、账号与限流
-
-- 2026-08-31 公开价格页的语音模型栏对 `FunAudioLLM/SenseVoiceSmall` 标注“免费”。
-- 这是免费模型计划，不是一次性赠送金；官方说明账单中调用消耗为 0。
-- 全部免费模型要求实名认证。限流为固定值，但公开 Rate Limits 页未给本模型的精确
-  RPM/RPD/音频时长额度；以登录后实际账号页为准。
-- 官方转写页明确保留模型上下线和服务能力调整的可能；价格/可用性需在发布前复核。
-
-## 4. 错误与适配要点
-
-官方错误体可为 `{code,message,data}` JSON，也可为纯文本。常见状态为 400/401/403/429/
-500/503/504；403 可与实名、模型权限或余额有关。SDK 的 `provider_http_error` 诊断文本保留
-HTTP status、可用的 `code/message/data`、文本 fallback 和脱敏追踪 ID；
-当前通用 `AiRuntimeError` 不提供结构化供应商错误 metadata。
-
-Say-It/SDK 接入是简单 Bearer + multipart HTTP，但不得透传硅基流动未公开的 OpenAI ASR
-扩展参数。中国大陆使用 `api.siliconflow.cn`；本轮未发起真实请求，实际账号限流未实测。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| ASR API、模型 ID、输入限制与响应 | 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 | 否 |
-| API Key | https://cloud.siliconflow.cn/account/ak | **是** |
+# SenseVoiceSmall · 硅基流动
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-31 |
+| 模态 | ASR（同步文件转写） |
+| 供应商 | SiliconFlow / SiliconCloud |
+| 平台模型 ID | `FunAudioLLM/SenseVoiceSmall` |
+| 当前公开价格 | **免费** |
+| 免费前提 | 账号实名认证；固定 Rate Limits，精确数值未公开 |
+| 文档/价格 | 公开无需登录；Key/实名/用量需登录 |
+
+## 1. 端点与鉴权
+
+```text
+POST https://api.siliconflow.cn/v1/audio/transcriptions
+Authorization: Bearer <SILICONFLOW_API_KEY>
+Content-Type: multipart/form-data
+```
+
+请求仅需两个官方公开字段：
+
+```text
+file=<binary audio file>
+model=FunAudioLLM/SenseVoiceSmall
+```
+
+`file` 必须不超过 1 小时、50 MB。官方 cURL 以 MP3 为示例，但转写页未公开完整文件
+格式白名单。公开协议没有 `language/prompt/response_format`、热词、说话人、情感或音频事件
+参数，也没有 WebSocket/SSE 实时接口。
+
+## 2. 响应契约
+
+```json
+{
+  "text": "<string>"
+}
+```
+
+响应头包含 `x-siliconcloud-trace-id`。虽然 SenseVoice 开源上游还有多语种、情感与音频事件能力，
+硅基流动当前转写 API 只声明 `text`。SDK 文档与类型不得保证端点会返回上游额外标签。
+
+## 3. 价格、账号与限流
+
+- 2026-08-31 公开价格页的语音模型栏对 `FunAudioLLM/SenseVoiceSmall` 标注“免费”。
+- 这是免费模型计划，不是一次性赠送金；官方说明账单中调用消耗为 0。
+- 全部免费模型要求实名认证。限流为固定值，但公开 Rate Limits 页未给本模型的精确
+  RPM/RPD/音频时长额度；以登录后实际账号页为准。
+- 官方转写页明确保留模型上下线和服务能力调整的可能；价格/可用性需在发布前复核。
+
+## 4. 错误与适配要点
+
+官方错误体可为 `{code,message,data}` JSON，也可为纯文本。常见状态为 400/401/403/429/
+500/503/504；403 可与实名、模型权限或余额有关。SDK 的 `provider_http_error` 诊断文本保留
+HTTP status、可用的 `code/message/data`、文本 fallback 和脱敏追踪 ID；
+当前通用 `AiRuntimeError` 不提供结构化供应商错误 metadata。
+
+Say-It/SDK 接入是简单 Bearer + multipart HTTP，但不得透传硅基流动未公开的 OpenAI ASR
+扩展参数。中国大陆使用 `api.siliconflow.cn`；本轮未发起真实请求，实际账号限流未实测。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| ASR API、模型 ID、输入限制与响应 | 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 | 否 |
+| API Key | https://cloud.siliconflow.cn/account/ak | **是** |

package/docs/model-adaptation/TeleSpeechASR/TeleSpeechASR_/347/241/205/345/237/272/346/265/201/345/212/250.md

@@ -1,72 +1,72 @@
-# TeleSpeechASR · 硅基流动
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-31 |
-| 模态 | ASR（同步文件转写） |
-| 供应商 | SiliconFlow / SiliconCloud |
-| 平台模型 ID | `TeleAI/TeleSpeechASR` |
-| 公开计费 | **未确认**：当前通用价格页未列该 ID |
-| 免费证据 | 官方“说点啥”用例将其列入该客户端的免费服务；不足以证明自有 Key 长期免费 |
-| 文档/价格 | 公开无需登录；Key/实名/用量需登录 |
-
-## 1. 端点与鉴权
-
-```text
-POST https://api.siliconflow.cn/v1/audio/transcriptions
-Authorization: Bearer <SILICONFLOW_API_KEY>
-Content-Type: multipart/form-data
-```
-
-请求仅需两个官方公开字段：
-
-```text
-file=<binary audio file>
-model=TeleAI/TeleSpeechASR
-```
-
-`file` 必须不超过 1 小时、50 MB。官方转写端点明确把该 ID 列为 `model` enum，但未公开
-完整文件格式白名单，也未在端点层公开语言清单、热词、说话人、时间戳或其它模型特性。
-公开协议没有 WebSocket/SSE 实时接口。
-
-## 2. 响应契约
-
-```json
-{
-  "text": "<string>"
-}
-```
-
-响应头包含 `x-siliconcloud-trace-id`。在硅基流动当前公开端点中，两个 ASR model enum 共用同一个
-`text` 响应形状；不得凭模型名称猜测额外字段。
-
-## 3. 价格与免费不确定项
-
-- 2026-08-31 公开通用价格页的语音模型栏未找到 `TeleAI/TeleSpeechASR`，因此无法从价格页确认
-  自有 API Key 调用的单价或免费身份。
-- 官方“说点啥”用例把 TeleSpeechASR 与 SenseVoiceSmall 列为该客户端可选的“免费服务”，
-  但同页又将关闭免费服务后的“自己 API Key”作为另一种路径。这不能等价为所有 SiliconCloud
-  账号下长期 0 费用。
-- SDK 可先记录模型可调用，但在未取得控制台账单证据前，价格不应写 0；发布前需用目标账号复核。
-
-## 4. 错误与适配要点
-
-官方错误体可为 `{code,message,data}` JSON，也可为纯文本。常见状态为 400/401/403/429/
-500/503/504。SDK 的 `provider_http_error` 诊断文本保留 HTTP status、可用的
-`code/message/data`、文本 fallback 和脱敏后的 `x-siliconcloud-trace-id`；当前通用
-`AiRuntimeError` 不提供结构化供应商错误 metadata。
-
-Say-It/SDK 接入是简单 Bearer + multipart HTTP，但只能提交 `file/model`；其它 ASR 参数在官方端点
-未公开时应隐藏。中国大陆使用 `api.siliconflow.cn`；本轮未发起真实请求，可用性、限流与
-计费均需目标账号实测。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| ASR API、模型 ID、输入限制与响应 | https://docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
-| 当前通用价格页（该 ID 未列出） | https://siliconflow.cn/pricing | 否 |
-| 免费模型/实名/Rate Limits 规则 | https://docs.siliconflow.cn/cn/userguide/rate-limits/rate-limit-and-upgradation | 否 |
-| 客户端免费服务证据 | https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-BiBiKeyboard | 否 |
-| 错误处理 | https://docs.siliconflow.cn/cn/faqs/error-code | 否 |
-| API Key | https://cloud.siliconflow.cn/account/ak | **是** |
+# TeleSpeechASR · 硅基流动
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-31 |
+| 模态 | ASR（同步文件转写） |
+| 供应商 | SiliconFlow / SiliconCloud |
+| 平台模型 ID | `TeleAI/TeleSpeechASR` |
+| 公开计费 | **未确认**：当前通用价格页未列该 ID |
+| 免费证据 | 官方“说点啥”用例将其列入该客户端的免费服务；不足以证明自有 Key 长期免费 |
+| 文档/价格 | 公开无需登录；Key/实名/用量需登录 |
+
+## 1. 端点与鉴权
+
+```text
+POST https://api.siliconflow.cn/v1/audio/transcriptions
+Authorization: Bearer <SILICONFLOW_API_KEY>
+Content-Type: multipart/form-data
+```
+
+请求仅需两个官方公开字段：
+
+```text
+file=<binary audio file>
+model=TeleAI/TeleSpeechASR
+```
+
+`file` 必须不超过 1 小时、50 MB。官方转写端点明确把该 ID 列为 `model` enum，但未公开
+完整文件格式白名单，也未在端点层公开语言清单、热词、说话人、时间戳或其它模型特性。
+公开协议没有 WebSocket/SSE 实时接口。
+
+## 2. 响应契约
+
+```json
+{
+  "text": "<string>"
+}
+```
+
+响应头包含 `x-siliconcloud-trace-id`。在硅基流动当前公开端点中，两个 ASR model enum 共用同一个
+`text` 响应形状；不得凭模型名称猜测额外字段。
+
+## 3. 价格与免费不确定项
+
+- 2026-08-31 公开通用价格页的语音模型栏未找到 `TeleAI/TeleSpeechASR`，因此无法从价格页确认
+  自有 API Key 调用的单价或免费身份。
+- 官方“说点啥”用例把 TeleSpeechASR 与 SenseVoiceSmall 列为该客户端可选的“免费服务”，
+  但同页又将关闭免费服务后的“自己 API Key”作为另一种路径。这不能等价为所有 SiliconCloud
+  账号下长期 0 费用。
+- SDK 可先记录模型可调用，但在未取得控制台账单证据前，价格不应写 0；发布前需用目标账号复核。
+
+## 4. 错误与适配要点
+
+官方错误体可为 `{code,message,data}` JSON，也可为纯文本。常见状态为 400/401/403/429/
+500/503/504。SDK 的 `provider_http_error` 诊断文本保留 HTTP status、可用的
+`code/message/data`、文本 fallback 和脱敏后的 `x-siliconcloud-trace-id`；当前通用
+`AiRuntimeError` 不提供结构化供应商错误 metadata。
+
+Say-It/SDK 接入是简单 Bearer + multipart HTTP，但只能提交 `file/model`；其它 ASR 参数在官方端点
+未公开时应隐藏。中国大陆使用 `api.siliconflow.cn`；本轮未发起真实请求，可用性、限流与
+计费均需目标账号实测。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| ASR API、模型 ID、输入限制与响应 | https://docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
+| 当前通用价格页（该 ID 未列出） | https://siliconflow.cn/pricing | 否 |
+| 免费模型/实名/Rate Limits 规则 | https://docs.siliconflow.cn/cn/userguide/rate-limits/rate-limit-and-upgradation | 否 |
+| 客户端免费服务证据 | https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-BiBiKeyboard | 否 |
+| 错误处理 | https://docs.siliconflow.cn/cn/faqs/error-code | 否 |
+| API Key | https://cloud.siliconflow.cn/account/ak | **是** |

package/docs/model-adaptation/Topaz-/345/233/276/347/211/207/346/224/276/345/244/247/Topaz-/345/233/276/347/211/207/346/224/276/345/244/247_Fal.md

@@ -1,87 +1,87 @@
-# Topaz 图片放大（Fal）
-
-## 定位
-
-- 端点：`topaz/upscale/image/precision`、`topaz/upscale/image/creative`、`topaz/upscale/image/generative`。
-- 类型：单图输入、单图输出的专业放大工具。
-- 产品边界：精确模式偏忠实放大；创意和生成模式会推断或重建细节，界面不得宣传为“无损”。
-- 官方资料核查日期：2026-08-29；文档公开，无需登录，真实调用需要 Fal API Key。
-
-## 公共协议
-
-| 项目 | 契约 |
-|---|---|
-| Base URL | 队列提交 `https://queue.fal.run/<endpoint-id>` |
-| 鉴权 | `Authorization: Key <FAL_KEY>` |
-| 提交 | `POST /<endpoint-id>`，请求体直接发送模型输入对象 |
-| 查询 | `GET /<endpoint-id>/requests/<request_id>/status` |
-| 结果 | `GET /<endpoint-id>/requests/<request_id>` |
-| 取消 | `PUT /<endpoint-id>/requests/<request_id>/cancel` |
-| 状态 | `IN_QUEUE` → `IN_PROGRESS` → `COMPLETED`；完成后仍需检查错误字段 |
-| 输出 | `image: File`，SDK 复用 Fal 通用 URL 提取与下载链路 |
-
-## 模式与字段
-
-| 模式 | 子模型 | 应用开放字段 | 隐藏或固定字段 |
-|---|---|---|---|
-| Precision | Standard V2、High Fidelity V3/V2、Low Resolution V2、CGI、Text Refine | 模型、2×/4×、人脸增强 | `crop_to_fill=false`；不发送 `output_format`、subject detection、sharpen、denoise 等高级字段 |
-| Creative | Bloom 2、Bloom、Bloom Realism | 模型、2×/4×；Bloom 2 额外开放 creativity 1～9 与颜色保留 | Bloom 2 的 autoprompt 使用 Topaz 默认；不发送 `output_format` |
-| Generative | Wonder 3.5/3/2、Wonder、Recover 3、Standard MAX、Recovery V2/Recovery | 模型、2×/4×、人脸增强；Wonder 3/3.5 开放重建强度 | 不发送 `output_format`、seed、prompt；Redefine 因依赖提示词引导而暂不开放 |
-
-应用默认使用 Precision / High Fidelity V3 / 2×，人脸增强默认关闭。启用人脸增强时固定下发
-`face_enhancement_creativity=0` 与 `face_enhancement_strength=0.8`，优先降低人物身份漂移。
-
-## 请求示例
-
-```json
-{
-  "image_url": "https://example.com/source.jpg",
-  "model": "High Fidelity V3",
-  "upscale_factor": 2,
-  "crop_to_fill": false,
-  "face_enhancement": false
-}
-```
-
-Bloom 2 会按需追加：
-
-```json
-{
-  "creativity": 4,
-  "color_preservation": true
-}
-```
-
-## 价格
-
-Fal 以实际输出像素按“每开始一档”计费，应用在上传前根据源图尺寸与倍率计算预计输出 MP：
-
-| 模式/子模型 | 官方单价 |
-|---|---|
-| Precision | 每开始 24 输出 MP `$0.08` |
-| Creative | 每开始 2 输出 MP `$0.08` |
-| Generative · Wonder 3.5 / Wonder 3 | 每开始 8 输出 MP `$0.08` |
-| Generative · 其他已开放子模型 | 每开始 4 输出 MP `$0.08` |
-
-Topaz 主入口在画布侧限制预计输出不超过 48MP，超过时在上传和创建付费任务前阻止。输入文件沿用应用
-20MiB 安全上限。透明图片改用独立的 Topaz Transparent 或 Bria 模型。
-
-## 适配与验证
-
-- SDK canonical ID：`topaz-image-upscale`；应用模型 ID：`fal-ai-topaz-image-upscale`。
-- 模式通过端点选择器路由，不在宿主或画布 UI 里按模型 ID 拼请求。
-- SDK 通过 `pricing.mediaContext` 声明输入/输出 MP 需求；宿主共享价格层读取源图尺寸并结合倍率计算，生成面板与画布共用，不发送给 Fal。画布执行前预检仍会复核同一输出 MP 与 48MP 上限。
-- 媒体指标尚未读取成功时不显示第一档兜底价，避免 2×/4× 被误报为同价。
-- 已完成端点、请求构建、非法参数回落、单图限制和四种计价档位的离线契约测试；未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| Precision API | https://fal.ai/models/topaz/upscale/image/precision/api | 否 |
-| Creative API | https://fal.ai/models/topaz/upscale/image/creative/api | 否 |
-| Generative API | https://fal.ai/models/topaz/upscale/image/generative/api | 否 |
-| Precision OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/precision | 否 |
-| Creative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/creative | 否 |
-| Generative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/generative | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# Topaz 图片放大（Fal）
+
+## 定位
+
+- 端点：`topaz/upscale/image/precision`、`topaz/upscale/image/creative`、`topaz/upscale/image/generative`。
+- 类型：单图输入、单图输出的专业放大工具。
+- 产品边界：精确模式偏忠实放大；创意和生成模式会推断或重建细节，界面不得宣传为“无损”。
+- 官方资料核查日期：2026-08-29；文档公开，无需登录，真实调用需要 Fal API Key。
+
+## 公共协议
+
+| 项目 | 契约 |
+|---|---|
+| Base URL | 队列提交 `https://queue.fal.run/<endpoint-id>` |
+| 鉴权 | `Authorization: Key <FAL_KEY>` |
+| 提交 | `POST /<endpoint-id>`，请求体直接发送模型输入对象 |
+| 查询 | `GET /<endpoint-id>/requests/<request_id>/status` |
+| 结果 | `GET /<endpoint-id>/requests/<request_id>` |
+| 取消 | `PUT /<endpoint-id>/requests/<request_id>/cancel` |
+| 状态 | `IN_QUEUE` → `IN_PROGRESS` → `COMPLETED`；完成后仍需检查错误字段 |
+| 输出 | `image: File`，SDK 复用 Fal 通用 URL 提取与下载链路 |
+
+## 模式与字段
+
+| 模式 | 子模型 | 应用开放字段 | 隐藏或固定字段 |
+|---|---|---|---|
+| Precision | Standard V2、High Fidelity V3/V2、Low Resolution V2、CGI、Text Refine | 模型、2×/4×、人脸增强 | `crop_to_fill=false`；不发送 `output_format`、subject detection、sharpen、denoise 等高级字段 |
+| Creative | Bloom 2、Bloom、Bloom Realism | 模型、2×/4×；Bloom 2 额外开放 creativity 1～9 与颜色保留 | Bloom 2 的 autoprompt 使用 Topaz 默认；不发送 `output_format` |
+| Generative | Wonder 3.5/3/2、Wonder、Recover 3、Standard MAX、Recovery V2/Recovery | 模型、2×/4×、人脸增强；Wonder 3/3.5 开放重建强度 | 不发送 `output_format`、seed、prompt；Redefine 因依赖提示词引导而暂不开放 |
+
+应用默认使用 Precision / High Fidelity V3 / 2×，人脸增强默认关闭。启用人脸增强时固定下发
+`face_enhancement_creativity=0` 与 `face_enhancement_strength=0.8`，优先降低人物身份漂移。
+
+## 请求示例
+
+```json
+{
+  "image_url": "https://example.com/source.jpg",
+  "model": "High Fidelity V3",
+  "upscale_factor": 2,
+  "crop_to_fill": false,
+  "face_enhancement": false
+}
+```
+
+Bloom 2 会按需追加：
+
+```json
+{
+  "creativity": 4,
+  "color_preservation": true
+}
+```
+
+## 价格
+
+Fal 以实际输出像素按“每开始一档”计费，应用在上传前根据源图尺寸与倍率计算预计输出 MP：
+
+| 模式/子模型 | 官方单价 |
+|---|---|
+| Precision | 每开始 24 输出 MP `$0.08` |
+| Creative | 每开始 2 输出 MP `$0.08` |
+| Generative · Wonder 3.5 / Wonder 3 | 每开始 8 输出 MP `$0.08` |
+| Generative · 其他已开放子模型 | 每开始 4 输出 MP `$0.08` |
+
+Topaz 主入口在画布侧限制预计输出不超过 48MP，超过时在上传和创建付费任务前阻止。输入文件沿用应用
+20MiB 安全上限。透明图片改用独立的 Topaz Transparent 或 Bria 模型。
+
+## 适配与验证
+
+- SDK canonical ID：`topaz-image-upscale`；应用模型 ID：`fal-ai-topaz-image-upscale`。
+- 模式通过端点选择器路由，不在宿主或画布 UI 里按模型 ID 拼请求。
+- SDK 通过 `pricing.mediaContext` 声明输入/输出 MP 需求；宿主共享价格层读取源图尺寸并结合倍率计算，生成面板与画布共用，不发送给 Fal。画布执行前预检仍会复核同一输出 MP 与 48MP 上限。
+- 媒体指标尚未读取成功时不显示第一档兜底价，避免 2×/4× 被误报为同价。
+- 已完成端点、请求构建、非法参数回落、单图限制和四种计价档位的离线契约测试；未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Precision API | https://fal.ai/models/topaz/upscale/image/precision/api | 否 |
+| Creative API | https://fal.ai/models/topaz/upscale/image/creative/api | 否 |
+| Generative API | https://fal.ai/models/topaz/upscale/image/generative/api | 否 |
+| Precision OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/precision | 否 |
+| Creative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/creative | 否 |
+| Generative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/generative | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |

package/docs/model-adaptation/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247_Fal.md

@@ -1,34 +1,34 @@
-# Topaz 透明图放大（Fal）
-
-## 契约
-
-| 项目 | 内容 |
-|---|---|
-| endpoint ID | `topaz/upscale/image/transparent` |
-| 输入 | `image_url`，应用严格要求 1 张图片 |
-| 输出 | 固定 4×、固定 PNG，保留 alpha 通道；`image: File` |
-| 参数 | 无用户参数；官方 `output_format` 固定为 PNG，应用不重复下发 |
-| 价格 | 每开始 24 输出 MP `$0.08`，按实际固定 4× 输出尺寸估价 |
-| 资料核查 | 2026-08-29；公开，无需登录 |
-
-## 队列与鉴权
-
-使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`：提交后轮询
-`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，再从结果中的 `image.url` 获取输出；取消使用 endpoint 与
-`request_id` 组成的 `/cancel` 地址。复用 SDK 现有 Fal 上传、轮询、取消和结果解析，不新增协议分支。
-
-## 适配决策
-
-- canonical ID：`topaz-transparent-upscale`；应用模型 ID：`fal-ai-topaz-transparent-upscale`。
-- 该模型独立于 Topaz 主入口，避免把固定 4× 和透明语义伪装成普通倍率选项。
-- `pricing.mediaContext` 声明固定 4× 的输出面积换算，宿主共享价格层读取源图尺寸后按输出 MP 阶梯估价；媒体指标不可用时不显示伪造兜底价。
-- 画布预检允许透明源图，并按相同的 4× 规则复核输出尺寸与价格；输入文件沿用 20MiB 安全上限。
-- 已完成端点、请求体、固定倍率、alpha 预检与像素阶梯计价的离线测试；未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API 文档 | https://fal.ai/models/topaz/upscale/image/transparent/api | 否 |
-| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/transparent | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# Topaz 透明图放大（Fal）
+
+## 契约
+
+| 项目 | 内容 |
+|---|---|
+| endpoint ID | `topaz/upscale/image/transparent` |
+| 输入 | `image_url`，应用严格要求 1 张图片 |
+| 输出 | 固定 4×、固定 PNG，保留 alpha 通道；`image: File` |
+| 参数 | 无用户参数；官方 `output_format` 固定为 PNG，应用不重复下发 |
+| 价格 | 每开始 24 输出 MP `$0.08`，按实际固定 4× 输出尺寸估价 |
+| 资料核查 | 2026-08-29；公开，无需登录 |
+
+## 队列与鉴权
+
+使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`：提交后轮询
+`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，再从结果中的 `image.url` 获取输出；取消使用 endpoint 与
+`request_id` 组成的 `/cancel` 地址。复用 SDK 现有 Fal 上传、轮询、取消和结果解析，不新增协议分支。
+
+## 适配决策
+
+- canonical ID：`topaz-transparent-upscale`；应用模型 ID：`fal-ai-topaz-transparent-upscale`。
+- 该模型独立于 Topaz 主入口，避免把固定 4× 和透明语义伪装成普通倍率选项。
+- `pricing.mediaContext` 声明固定 4× 的输出面积换算，宿主共享价格层读取源图尺寸后按输出 MP 阶梯估价；媒体指标不可用时不显示伪造兜底价。
+- 画布预检允许透明源图，并按相同的 4× 规则复核输出尺寸与价格；输入文件沿用 20MiB 安全上限。
+- 已完成端点、请求体、固定倍率、alpha 预检与像素阶梯计价的离线测试；未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API 文档 | https://fal.ai/models/topaz/upscale/image/transparent/api | 否 |
+| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/transparent | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |