@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation/GPT-OSS-20B/GPT-OSS-20B_Groq.md

@@ -1,62 +1,62 @@
-# GPT-OSS 20B · Groq
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-28 |
-| 模态 | LLM（文本生成/推理） |
-| 供应商 | GroqCloud（不是 xAI Grok） |
-| 平台模型 ID | `openai/gpt-oss-20b` |
-| Say-It 决策 | 保留为 Groq 默认模型 |
-| 文档/价格 | 公开无需登录；Key/账单需登录 |
-
-## 1. 端点与鉴权
-
-```text
-POST https://api.groq.com/openai/v1/chat/completions
-Authorization: Bearer <GROQ_API_KEY>
-Content-Type: application/json
-```
-
-可复用 OpenAI 兼容 Chat/SSE 传输。必填 `model/messages`，支持 `stream/tools/response_format/max_completion_tokens/temperature/top_p/stop/seed`。`n` 只能为 1；`logprobs/logit_bias/top_logprobs/messages[].name` 会返回 400。
-
-## 2. 模型发现
-
-```text
-GET https://api.groq.com/openai/v1/models
-GET https://api.groq.com/openai/v1/models/openai/gpt-oss-20b
-```
-
-两个端点都需 Bearer Key。列表返回 `data[]`，包含 `id/active/context_window/owned_by`；单模型还可返 `max_completion_tokens`。Say-It 可默认选本模型，同时允许用户从实时模型列表切换。
-
-## 3. 推理参数
-
-- `reasoning_effort`: `low|medium|high`，默认 `medium`。
-- GPT-OSS 20B **不支持 `reasoning_format`**。默认的 reasoning 在 assistant message 的 `reasoning` 字段。
-- 可用 `include_reasoning=false` 隐藏推理；`include_reasoning` 与 `reasoning_format` 互斥。
-
-Say-It 现有为 Groq Qwen3 设置 `reasoning_effort=none/default` 和 `reasoning_format=parsed` 的逻辑不能套到本模型。
-
-## 4. 能力、限制与价格
-
-| 项目 | 官方当前值 |
-|---|---|
-| 状态 | Production |
-| 上下文 | 131,072 tokens |
-| 最大输出 | 65,536 tokens |
-| 速度 | 约 1000 tokens/s |
-| Developer Plan | 250K TPM / 1K RPM |
-| 输入 | $0.075 / 1M tokens |
-| 输出 | $0.30 / 1M tokens |
-
-错误体 `{error:{message,type}}`。对 429/498/500/502/503 进行受控重试，但 400/401/403/404/413/422 不盲目重试；499 归一为用户取消。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| 模型状态/价格/限制 | https://console.groq.com/docs/models | 否 |
-| OpenAI 兼容 | https://console.groq.com/docs/openai | 否 |
-| Chat/Models API | https://console.groq.com/docs/api-reference | 否 |
-| Reasoning | https://console.groq.com/docs/reasoning | 否 |
-| 错误码 | https://console.groq.com/docs/errors | 否 |
-| API Key | https://console.groq.com/keys | **是** |
+# GPT-OSS 20B · Groq
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 模态 | LLM（文本生成/推理） |
+| 供应商 | GroqCloud（不是 xAI Grok） |
+| 平台模型 ID | `openai/gpt-oss-20b` |
+| Say-It 决策 | 保留为 Groq 默认模型 |
+| 文档/价格 | 公开无需登录；Key/账单需登录 |
+
+## 1. 端点与鉴权
+
+```text
+POST https://api.groq.com/openai/v1/chat/completions
+Authorization: Bearer <GROQ_API_KEY>
+Content-Type: application/json
+```
+
+可复用 OpenAI 兼容 Chat/SSE 传输。必填 `model/messages`，支持 `stream/tools/response_format/max_completion_tokens/temperature/top_p/stop/seed`。`n` 只能为 1；`logprobs/logit_bias/top_logprobs/messages[].name` 会返回 400。
+
+## 2. 模型发现
+
+```text
+GET https://api.groq.com/openai/v1/models
+GET https://api.groq.com/openai/v1/models/openai/gpt-oss-20b
+```
+
+两个端点都需 Bearer Key。列表返回 `data[]`，包含 `id/active/context_window/owned_by`；单模型还可返 `max_completion_tokens`。Say-It 可默认选本模型，同时允许用户从实时模型列表切换。
+
+## 3. 推理参数
+
+- `reasoning_effort`: `low|medium|high`，默认 `medium`。
+- GPT-OSS 20B **不支持 `reasoning_format`**。默认的 reasoning 在 assistant message 的 `reasoning` 字段。
+- 可用 `include_reasoning=false` 隐藏推理；`include_reasoning` 与 `reasoning_format` 互斥。
+
+Say-It 现有为 Groq Qwen3 设置 `reasoning_effort=none/default` 和 `reasoning_format=parsed` 的逻辑不能套到本模型。
+
+## 4. 能力、限制与价格
+
+| 项目 | 官方当前值 |
+|---|---|
+| 状态 | Production |
+| 上下文 | 131,072 tokens |
+| 最大输出 | 65,536 tokens |
+| 速度 | 约 1000 tokens/s |
+| Developer Plan | 250K TPM / 1K RPM |
+| 输入 | $0.075 / 1M tokens |
+| 输出 | $0.30 / 1M tokens |
+
+错误体 `{error:{message,type}}`。对 429/498/500/502/503 进行受控重试，但 400/401/403/404/413/422 不盲目重试；499 归一为用户取消。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| 模型状态/价格/限制 | https://console.groq.com/docs/models | 否 |
+| OpenAI 兼容 | https://console.groq.com/docs/openai | 否 |
+| Chat/Models API | https://console.groq.com/docs/api-reference | 否 |
+| Reasoning | https://console.groq.com/docs/reasoning | 否 |
+| 错误码 | https://console.groq.com/docs/errors | 否 |
+| API Key | https://console.groq.com/keys | **是** |

package/docs/model-adaptation/Gemini-3.8-Flash-Lite-TTS/Gemini-3.8-Flash-Lite-TTS_KIE.md

@@ -0,0 +1,22 @@
+# Gemini 3.8 Flash-Lite TTS · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `kie-gemini-3.8-flash-lite-tts`，通用标识 `gemini-3.8-flash-lite-tts` |
+| model ID | `google/gemini-3-8-flash-lite-tts` |
+| 文档与价格 | 公开，无需登录 |
+| 定价 | 项目按原价估：输入 $0.70、音频输出 $8.40 每百万 Token。当前限时价为输入 $0.35、音频输出 $4.20（70 / 840 积分），比官方价低 30%、跟随 Google 促销价至 2026-12-31；Google 官方 2026 年内为 $0.50 / $6.00，2027-01-01 起 $1.00 / $12.00，原价按同样七折推算（2026-11-07 核对 [Google 价格页](https://ai.google.dev/gemini-api/docs/pricing)） |
+
+## 请求契约
+
+字段、音色表（70 个，默认 Fola）、逐句 `style` 与 [Gemini 3.8 Flash TTS](../Gemini-3.8-Flash-TTS/Gemini-3.8-Flash-TTS_KIE.md) 一致（2026-11-07 对比两份官方 schema），只有 model ID 与输出单价不同。项目两者共用 `catalog/kie/gemini38Tts.ts`。
+
+上限估价按输入 8192、输出 16384 Token 预留，约 $0.0717，实际以 KIE 账单为准。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Gemini 3.8 Flash Lite Text to speech](https://docs.kie.ai/market/google/gemini-3-8-flash-lite-tts.md)
+- [模型页（含限时价说明）](https://kie.ai/gemini-3.8-flash-lite-tts)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对输入/音频输出两行）

package/docs/model-adaptation/Gemini-3.8-Flash-TTS/Gemini-3.8-Flash-TTS_KIE.md

@@ -0,0 +1,38 @@
+# Gemini 3.8 Flash TTS · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `kie-gemini-3.8-flash-tts`，通用标识 `gemini-3.8-flash-tts`；Lite 见 [Gemini-3.8-Flash-Lite-TTS_KIE.md](../Gemini-3.8-Flash-Lite-TTS/Gemini-3.8-Flash-Lite-TTS_KIE.md) |
+| model ID | `google/gemini-3-8-flash-tts` |
+| 输出 | WAV（16-bit PCM，24 kHz，单声道） |
+| 文档与价格 | 公开，无需登录 |
+| 定价 | 项目按原价估：输入 $0.70、音频输出 $12.60 每百万 Token。当前限时价为输入 $0.35、音频输出 $6.30（70 / 1260 积分），模型页注明比官方价低 30%、跟随 Google 促销价至 2026-12-31；Google 官方 2026 年内为 $0.50 / $9.00，2027-01-01 起 $1.00 / $18.00，原价按同样七折推算（2026-11-07 核对 [Google 价格页](https://ai.google.dev/gemini-api/docs/pricing)） |
+
+## 请求契约
+
+`POST https://api.kie.ai/api/v1/jobs/createTask`，`{model,input}`。与 3.1 的差异：没有 `scene`/`sample_context`；音色表换成 70 个；台词可带逐句 `style`。
+
+| input 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| speakers | 必填，`{speaker_id:"Speaker N", voice_name}`；`voice_name` 与 `replica`（声音克隆）互斥，都不传默认 Fola | 单说话人，音色选择器（70 个预设，默认 Fola）；`replica` 不开放 |
+| dialogue_turns | 必填，`{speaker_id,text,style?}`；text ≤10000，可含 `<laugh>` 等语气标签；`style` 为 3.8 专属逐句风格描述 | 单句台词；“说话风格”填入 `style` |
+| temperature | 0–2，默认 1 | “表现变化” |
+| filler_words | 仅两人对话时生效，默认关 | 单说话人，不显示、不请求 |
+
+助手可经隐藏参数 `kieGeminiTtsSpeakers` / `kieGeminiTtsDialogueTurns` 直接传多说话人结构，与 3.1 相同。
+
+## 计价说明
+
+官方按 Token 计费，没有每次价格。项目沿用 3.1 的上限估价方式：按输入 8192、输出 16384 Token 预留，约 $0.1061，标为估算，实际以 KIE 账单为准。
+
+## 事件与失败契约
+
+沿用 [KIE 供应商文档](../供应商/KIE.md) 第 2 节 Market 统一任务契约。官方请求 schema 见 `tests/fixtures/model-requests-2026-11/kie-gemini-3.8-flash-tts.json`；未做付费真网验收。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Gemini 3.8 Flash Text to speech](https://docs.kie.ai/market/google/gemini-3-8-flash-tts.md)
+- [模型页（含限时价说明）](https://kie.ai/gemini-3.8-flash-tts)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对输入/音频输出两行）

package/docs/model-adaptation/Gemini-Omni-1.2-Flash/Gemini-Omni-1.2-Flash_APIMart.md

@@ -0,0 +1,79 @@
+# Gemini Omni 1.2 Flash · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-gemini-omni-1.2-flash`（通用标识 `gemini-omni-1.2-flash`） |
+| 平台模型 ID | 官方：`gemini-omni-1.2-flash`；Ext：`gemini-omni-1.2-flash-ext` |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`，每 5–10 秒轮询，建议整体超时 10 分钟；完成后读 `data.result.videos[0].url[0]`，`data.cost` 为最终结算
+- 输出 24fps、含音频，带 SynthID 水印；参数类错误（`invalid_*`）使任务立即 `failed` 且不扣费
+
+## 2. 能力
+
+| 能力 | 官方 `gemini-omni-1.2-flash` | Ext `gemini-omni-1.2-flash-ext` |
+|---|---|---|
+| 文生视频 | 3–15 秒 | 3–15 秒 |
+| 首帧图生视频 | 支持 | 支持 |
+| 首尾帧插值 | 支持（3–10 秒） | **不支持**（`last_frame_image` 报 400） |
+| 多图参考 | 图片与首尾帧合计 ≤ 10 | 1–10 张 |
+| 视频编辑 | `video_urls` 1 段 ≤ 15 秒，`duration` 被忽略 | 同左，**传 `duration` 报错** |
+| 视频续写 | `omni_reference_task_type: "extend"`，新增 ≤ 10 秒 | 同左，新增 3–10 秒 |
+| `extend_from_task_id` | 支持 | 支持（需本账号已完成的 Ext 任务） |
+
+## 3. 请求参数
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | 见上表 | 必填 |
+| `prompt` | string | **所有模式必填**，缺少返回 400 |
+| `duration` | 3–15 | 默认 10；首尾帧与续写 ≤ 10；编辑不传 |
+| `resolution` | `360p` / `720p` / `1080p` / `4k`（`2160p` 视为 `4k`） | 默认 `720p`；1080p / 4k 为上采样 |
+| `aspect_ratio` | `16:9` / `9:16` | 官方其他值按 16:9；Ext 不传时跟随素材 |
+| `image_urls` | 公网 HTTP(S) | 不支持 Data URL / Base64 |
+| `first_frame_image` / `last_frame_image` / `image_with_roles` | 公网 HTTP(S) | Ext 无尾帧 |
+| `video_urls` | 1 段，≤ 15 秒（Ext 另限 MP4/MOV/WebM、≤ 64 MB） | |
+| `omni_reference_task_type` | `auto` / `edit` / `extend` / `reference`（及 `text_to_video` 等别名） | Ext 带视频时必须传 |
+| `extend_from_task_id` | 平台任务 ID | 引用自己上一次的生成任务续写，与 `video_urls` 互斥，需配 `omni_reference_task_type: "extend"`（不配默认按编辑）；`prompt` 仍必填，`duration` 为新增秒数 3–10。Ext 只认本账号已完成的 Ext 任务，原成片不能超过 15 秒，原通道不可用返回 503 `source_channel_unavailable` |
+| `negative_prompt` / `system_prompt` | 仅 Ext | 项目不请求 |
+
+## 4. 价格
+
+来源：[Gemini Omni 1.2 Flash 模型页](https://apimart.ai/zh/model/gemini-omni-1-2-flash)（2026-11-07 读取，黄金价 = 当前价）；定价中心起步价 `gemini-omni-1.2-flash $0.02/秒` 一致。
+
+| 分辨率 | 官方（每秒） | Ext（每秒） |
+|---|---|---|
+| 360p | $0.02 | $0.016 |
+| 720p | $0.06 | $0.024 |
+| 1080p | $0.0904 | $0.024 |
+| 4k | $0.1808 | $0.056 |
+
+计费秒数：文生 / 图生 / 多图参考按 `duration`；编辑按源视频时长（Ext 文档：扣除 0.15 秒容器误差后向上取整，最少 1 秒）；续写只按新增秒数。官方文档写“按 token 计费”，模型页按分辨率给出每秒价，项目按每秒价估算。官方提交时按 `max(10, duration)` 秒预扣，带视频按 15 秒预扣，成功后多退少补。
+
+## 5. 项目适配
+
+- 新建独立模型而不并入 `apimart-gemini-omni-flash`：旧模型的通用标识是 `gemini-omni-video`（对应 Gemini Omni Flash 预览版），1.2 Flash 是另一个跨供应商的通用模型 `gemini-omni-1.2-flash`，合并会让同一模型卡片挂两个通用标识。
+- 顶层 `role: 'channel'` 渠道（默认官方）+ `role: 'mode'` 模式：文/图生视频（0 张文生、1 张首帧、2 张首尾帧；Ext 最多 1 张）、多图参考、视频编辑、视频续写。
+- 时长默认 10；编辑模式隐藏并不发送；续写模式范围收为 3–10；首尾帧在请求构建时收为 ≤ 10。
+- 比例：编辑与续写跟随输入视频；Ext 渠道带首帧或参考图时不传 `aspect_ratio` 以跟随素材。这些情况下比例选项隐藏且不发送。
+- 续写自己的结果：模型声明续接 `extend`（同模型），完成时取平台 `task_id` 作为引用；续接参数切到续写模式、去掉源请求的图和视频、时长收到 ≤ 10，带进输入区由用户改提示词与时长后提交。请求发 `extend_from_task_id` + `omni_reference_task_type: "extend"` + `duration`，不发 `video_urls`，此时不要求输入视频、也不能再上传素材。续写只能接同渠道的源任务，所以续接时渠道与模式沿用源任务、不显示也不让改。任务 ID 只在请求构建里使用，不进入界面。
+- 不显示、不请求：`negative_prompt`、`system_prompt`。
+- APIMart 没有通用视频上传端点，视频素材必须是公网 URL。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：首尾帧（两张图）与续写最长 10 秒：展示层联动把时长上限收到 10，超出的旧值改为 10，界面与请求一致。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 官方渠道 API 文档 | https://docs.apimart.ai/cn/api-reference/videos/gemini-omni-1.2-flash/generation | 否 |
+| Ext 渠道 API 文档 | https://docs.apimart.ai/cn/api-reference/videos/gemini-omni-1.2-flash-ext/generation | 否 |
+| 模型页（两渠道价格） | https://apimart.ai/zh/model/gemini-omni-1-2-flash | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Gemini-Omni-1.2-Flash/Gemini-Omni-1.2-Flash_Fal.md

@@ -0,0 +1,60 @@
+# Gemini Omni 1.2 Flash · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `google/gemini-omni-flash/v1.2/{text-to-video,image-to-video,reference-to-video,edit,extend}` |
+| 痕迹AI 模型 ID | `fal-ai-gemini-omni-1.2-flash`（canonical `gemini-omni-1.2-flash`，与 1.0 的 `fal-ai-gemini-omni-flash` 同属 `gemini-omni` 系列） |
+| 接口形态 | Fal 队列异步 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求参数（OpenAPI，2026-11-07 读取）
+
+| 端点 | 字段 |
+|---|---|
+| `text-to-video` | `prompt`（必填，≤20000 字）、`aspect_ratio`（`16:9`/`9:16`，默认 `16:9`）、`resolution`（`360p`/`720p`/`1080p`/`4k`，默认 `720p`）、`duration`（3–15，默认 8） |
+| `image-to-video` | 上述字段 + `image_url`（必填，首帧）+ `end_image_url`（可选尾帧；给出时时长最长 10 秒） |
+| `reference-to-video` | 上述文生字段 + `image_urls`（≤10）+ `reference_video_urls`（≤3，每段 ≤15 秒） |
+| `edit` | `prompt`（必填）、`video_url`（必填，≤15 秒）、`resolution` |
+| `extend` | `prompt`（必填）、`video_url`（必填，任意长度，模型以最后 10 秒为条件续写）、`resolution`、`duration`（3–10，默认 8） |
+| `upscale`（未接） | `video_url`、`resolution`（`720p`/`1080p`/`4k`，须高于源） |
+
+响应：`{ "video": { "url" } }`。
+
+## 2. 价格（模型页 pricingInfoOverride / publicEndpointBilling，2026-11-07 读取）
+
+| 分辨率 | 单价（按输出秒数） |
+|---|---|
+| 360p | $0.0273/秒 |
+| 720p | $0.0819/秒 |
+| 1080p | $0.1229/秒 |
+| 4K | $0.2457/秒 |
+
+- 含原生音频；图生的输入图、参考图与参考视频不计费。
+- 编辑按编辑后的输出秒数计费（输出与源视频等长）；延长只计新生成部分，输入视频不计费。
+- 放大（未接）：360p→720p 或 720p→1080p $0.041/秒，360p→1080p $0.0819/秒，720p/1080p→4K $0.1638/秒。
+
+## 3. 适配要点
+
+- 1.0 的现有模型只有图生与参考，且 canonical 为 `gemini-omni-video`；1.2 能力、参数与价格都不同，新建模型而不是在 1.0 文件里加版本选项。
+- 一个模型、显式 `mode`：文/图生视频（0/1/2 张图自动路由）、参考生视频、视频编辑、延长视频。
+- 时长按分支钳制：首尾帧与延长 ≤10 秒，其余 ≤15 秒；编辑不下发时长，计价按源视频时长（≤15 秒，未知按 8 秒估）。
+- `upscale` 属于放大工具，计价依赖源分辨率，未接入。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：首尾帧（两张图）与延长视频最长 10 秒：展示层联动把时长上限收到 10，超出的旧值改为 10，界面与请求一致。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=google/gemini-omni-flash/v1.2/text-to-video | 否 |
+| 图生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=google/gemini-omni-flash/v1.2/image-to-video | 否 |
+| 参考生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=google/gemini-omni-flash/v1.2/reference-to-video | 否 |
+| 视频编辑 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=google/gemini-omni-flash/v1.2/edit | 否 |
+| 延长视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=google/gemini-omni-flash/v1.2/extend | 否 |
+| 放大 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=google/gemini-omni-flash/v1.2/upscale | 否 |
+| 模型页与价格 | https://fal.ai/models/google/gemini-omni-flash/v1.2/text-to-video | 否 |
+| 编辑 / 延长价格 | https://fal.ai/models/google/gemini-omni-flash/v1.2/edit 、https://fal.ai/models/google/gemini-omni-flash/v1.2/extend | 否 |

package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_APIMart.md

@@ -1,125 +1,131 @@
-# Gemini Omni Flash · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | APIMart（聚合平台） |
-| 平台模型 ID | **两条独立渠道**：`gemini-omni-flash-preview`（官方直连）与 `Omni-Flash-Ext` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> APIMart 上 Gemini Omni Flash 是两个平台模型、两份文档，能力集合与限制差异很大；Henji 产品中统一为一个“Gemini Omni Flash”入口，通过首项“渠道”（普通 / 官方）切换，运行时仍严格按各渠道契约、价格和限制分支。
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.apimart.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /v1/videos/generations` → `{ code: 200, data: [{ status: "submitted", task_id }] }`
-- **查询**：`GET /v1/tasks/{task_id}`
-- **轮询建议**（`Omni-Flash-Ext` 文档）：提交后等 **5–10 秒**再开始查询，之后每 5–10 秒一次；**单个任务通常约 3–5 分钟完成**
-
----
-
-## 2. 渠道 A：`gemini-omni-flash-preview`（Google 官方直连）
-
-Google 官方 Gemini Omni Flash 全能多模态视频生成模型。支持文生视频、图生视频、**视频生视频（编辑）**，可混合文本 + 图片 + 视频输入。输出 **720p / 24fps / 3–10 秒 / 含音频**；支持**对话式多轮编辑**。
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必填 | — | 固定 `gemini-omni-flash-preview` |
-| `prompt` | string | 必填 | — | 文本指令。文生视频为场景描述；图/视频生视频为动作/风格/编辑指令。**`prompt` 与参考素材（`image_urls` / `video_urls`）至少提供其一** |
-| `image_urls` | array | 可选 | — | 参考图，**最多 16 张**。`http(s)://` URL，支持 JPEG / PNG。多主体可传多张并在 prompt 中描述互动 |
-| `video_urls` | array | 可选 | — | 参考 / 待编辑视频，**最多 1 个**（不支持多视频引用）。`http(s)://` 直链或 `data:video/...`。**参考视频 1–24 秒，官方建议 ≤ 3 秒**。**与 `extend_from_task_id` 互斥** |
-| `aspect_ratio` | string | 可选 | `16:9` | **仅 `16:9` / `9:16`**，其它值按 `16:9` 处理。**传入 `video_urls` 后本参数失效** |
-| `resolution` | string | 可选 | `720p` | **当前仅支持 `720p`** |
-| `extend_from_task_id` | string | 可选 | — | 上一次生成任务的 `task_id`（对话式多轮编辑）。**与 `video_urls` 互斥** |
-| `nsfw_check` | boolean | 可选 | `false` | 提交前内容审核 |
-
-### 价格（`GEMINI-OMNI-FLASH-PREVIEW`）
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)（2026-08-22，1 个档位）。
-
-| 规格 | 我们的价格 | 官方价 | 节省 |
-|---|---|---|---|
-| 720P | 0.88 Credits/秒 ≈ **$0.088/秒** | $0.11 | 20% |
-
----
-
-## 3. 渠道 B：`Omni-Flash-Ext`
-
-统一视频生成模型。支持文生视频、单图生视频、**参考视频**和 **3 张参考图融合**；支持 **720p / 1080p / 4k**，**4 / 6 / 8 / 10 秒**。
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必填 | — | 固定 `Omni-Flash-Ext` |
-| `prompt` | string | 必填 | — | 建议详细描述场景、人物、动作、环境、镜头运动、画面风格和**音频提示** |
-| `duration` | integer | 可选 | `6` | **仅支持 `4`、`6`、`8`、`10`**；传 5、7 等返回 `invalid_duration`。**传入 `video_urls` 时不需要也不能同时传 `duration`** |
-| `resolution` | string | 可选 | `720p` | `720p` / `1080p` / `4k`（**不区分大小写**）；其它返回 `invalid_resolution` |
-| `aspect_ratio` | string | 可选 | `16:9` | `16:9` / `9:16` |
-| `size` | string | 可选 | — | 兼容字段，含义同 `aspect_ratio`；同时传入时建议保持一致 |
-| `generation_type` | string | 可选 | — | `frame`（首帧模式，`image_urls` **只能 1 张**）/ `reference`（参考模式，`image_urls` **可 1 张或 3 张**） |
-| `image_urls` | array | 可选 | — | 可不传（文生视频）/ 1 张（单图生视频）/ 3 张（参考图融合，仅 `generation_type=reference`）。**不支持 2 张图的首尾帧模式**，传 2 张返回 `unsupported_image_count`；4 张及以上未实测验证，不建议使用。只支持公网可访问 URL |
-| `video_urls` | array | 可选 | — | **0 或 1 个**参考视频；2 个及以上返回 `unsupported_video_count`。**可与 `image_urls` 同时传入**（图片作身份/构图参考，视频作动态参考）。只支持公网 HTTP/HTTPS URL |
-| `nsfw_check` | boolean | 可选 | `false` | 提交前内容审核 |
-
-### 错误码
-
-| HTTP | 错误类型 | 含义 | 处理建议 |
-|---|---|---|---|
-| 400 | `invalid_request_error` | `model` 不是 `Omni-Flash-Ext`、`prompt` 为空或 JSON 格式错误 | 检查请求体 |
-| 400 | `invalid_duration` | `duration` 不是 4/6/8/10 | 改成支持的时长 |
-| 400 | `invalid_resolution` | `resolution` 不是 720p/1080p/4k | 改成支持的分辨率 |
-| 400 | `unsupported_image_count` | `image_urls` 数量不受支持（常见于传 2 张） | 改成 0、1 或 3 张 |
-| 400 | `unsupported_video_count` | `video_urls` 传了 2 个及以上 | 改成 0 或 1 个 |
-| 401 | `authentication_error` | Token 无效 | 检查 Bearer Token |
-| 402 | `payment_required` | 余额不足 | 充值后重试 |
-| 429 | `rate_limit_error` | 触发限流 | 降低并发或稍后重试 |
-
-任务失败时，任务查询接口在 `data.error` 返回失败原因，常见为上游配额暂时耗尽、内容审核未通过或上游超时。
-
-### 价格（`OMNI-FLASH-EXT`）
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)（2026-08-22，**16 个档位，按次计费**，1 Credit ≈ $0.1）。
-
-| 规格 | 我们的价格 | 官方价 | 节省 |
-|---|---|---|---|
-| 默认 | 3.5 Credits/次 ≈ **$0.35/次** | $0.4375 | 20% |
-| 720P-4S | 2.5 ≈ **$0.25/次** | $0.3125 | 20% |
-| 720P-6S | 3 ≈ **$0.3/次** | $0.375 | 20% |
-| 720P-8S | 3.5 ≈ **$0.35/次** | $0.4375 | 20% |
-| 720P-10S | 4 ≈ **$0.4/次** | $0.5 | 20% |
-| 720P-VIDREF | 0.8 ≈ **$0.08/次** | $0.1 | 20% |
-| 1080P-4S | 2.5 ≈ **$0.25/次** | $0.3125 | 20% |
-| 1080P-6S | 3 ≈ **$0.3/次** | $0.375 | 20% |
-| 1080P-8S | 3.5 ≈ **$0.35/次** | $0.4375 | 20% |
-| 1080P-10S | 4 ≈ **$0.4/次** | $0.5 | 20% |
-| 1080P-VIDREF | 0.8 ≈ **$0.08/次** | $0.1 | 20% |
-| 4K-4S | 7.5 ≈ **$0.75/次** | $0.9375 | 20% |
-| 4K-6S | 8 ≈ **$0.8/次** | $1 | 20% |
-| 4K-8S | 8.5 ≈ **$0.85/次** | $1.0625 | 20% |
-| 4K-10S | 9 ≈ **$0.9/次** | $1.125 | 20% |
-| 4K-VIDREF | 2.4 ≈ **$0.24/次** | $0.3 | 20% |
-
-> **按次计费**（不是按秒），且 720P 与 1080P 同价；`VIDREF`（有参考视频）档位便宜很多。
-
-## 4. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 这两条渠道都没有这两个字段。
-- **两条渠道差异极大**：官方渠道只有 720p、时长 3–10 秒、参考图最多 16 张、支持 `extend_from_task_id` 多轮编辑；Ext 渠道有 1080p/4k、时长只能 4/6/8/10、参考图只能 0/1/3 张、没有多轮编辑。产品入口可以合并，但渠道选择必须驱动参数显隐、校验、请求、轮询与计价，不能把两套契约混用。
-- `extend_from_task_id`（多轮延续）需要填供应商侧的上一次任务 ID，本应用界面不展示任务 ID、用户拿不到：当前**不注册、不下发**（界面计划 5.8，P-17）。以后要支持，应做成生成记录上的“继续编辑”动作，由应用自己带上任务 ID，而不是参数输入框。
-- Ext 渠道**不支持 2 张图的首尾帧**——这是与几乎所有其他视频模型都不同的限制，UI 必须挡住。
-- Ext 渠道传参考视频时**不能同时传 `duration`**。
-- 官方渠道传 `video_urls` 后 `aspect_ratio` 失效。
-- Ext 渠道按次计费，时长与分辨率决定档位，成本估算逻辑与「按秒」模型完全不同。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Gemini Omni Flash 视频生成（官方渠道） | https://docs.apimart.ai/cn/api-reference/videos/gemini-omni-flash-preview/generation | 否 |
-| Omni-Flash-Ext 视频生成 | https://docs.apimart.ai/cn/api-reference/videos/omni-flash-ext/generation | 否 |
-| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
-| 定价中心（视频标签页搜 GEMINI-OMNI-FLASH-PREVIEW / OMNI-FLASH-EXT） | https://apimart.ai/zh/pricing | 否 |
-| API Key 管理 | https://apimart.ai/keys | **是** |
+# Gemini Omni Flash · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | **两条独立渠道**：`gemini-omni-flash-preview`（官方直连）与 `Omni-Flash-Ext` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> APIMart 上 Gemini Omni Flash 是两个平台模型、两份文档，能力集合与限制差异很大；Henji 产品中统一为一个“Gemini Omni Flash”入口，通过首项“渠道”（普通 / 官方）切换，运行时仍严格按各渠道契约、价格和限制分支。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/videos/generations` → `{ code: 200, data: [{ status: "submitted", task_id }] }`
+- **查询**：`GET /v1/tasks/{task_id}`
+- **轮询建议**（`Omni-Flash-Ext` 文档）：提交后等 **5–10 秒**再开始查询，之后每 5–10 秒一次；**单个任务通常约 3–5 分钟完成**
+
+---
+
+## 2. 渠道 A：`gemini-omni-flash-preview`（Google 官方直连）
+
+Google 官方 Gemini Omni Flash 全能多模态视频生成模型。支持文生视频、图生视频、**视频生视频（编辑）**，可混合文本 + 图片 + 视频输入。输出 **720p / 24fps / 3–10 秒 / 含音频**；支持**对话式多轮编辑**。
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | — | 固定 `gemini-omni-flash-preview` |
+| `prompt` | string | 必填 | — | 文本指令。文生视频为场景描述；图/视频生视频为动作/风格/编辑指令。**`prompt` 与参考素材（`image_urls` / `video_urls`）至少提供其一** |
+| `image_urls` | array | 可选 | — | 参考图，**最多 16 张**。`http(s)://` URL，支持 JPEG / PNG。多主体可传多张并在 prompt 中描述互动 |
+| `video_urls` | array | 可选 | — | 参考 / 待编辑视频，**最多 1 个**（不支持多视频引用）。`http(s)://` 直链或 `data:video/...`。**参考视频 1–24 秒，官方建议 ≤ 3 秒**。**与 `extend_from_task_id` 互斥** |
+| `aspect_ratio` | string | 可选 | `16:9` | **仅 `16:9` / `9:16`**，其它值按 `16:9` 处理。**传入 `video_urls` 后本参数失效** |
+| `resolution` | string | 可选 | `720p` | **当前仅支持 `720p`** |
+| `extend_from_task_id` | string | 可选 | — | 上一次生成任务的 `task_id`（对话式多轮编辑）。**与 `video_urls` 互斥** |
+| `nsfw_check` | boolean | 可选 | `false` | 提交前内容审核 |
+
+### 价格（`GEMINI-OMNI-FLASH-PREVIEW`）
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)（2026-08-22，1 个档位）。
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 720P | 0.88 Credits/秒 ≈ **$0.088/秒** | $0.11 | 20% |
+
+---
+
+## 3. 渠道 B：`Omni-Flash-Ext`
+
+统一视频生成模型。支持文生视频、单图生视频、**参考视频**和 **3 张参考图融合**；支持 **720p / 1080p / 4k**，**4 / 6 / 8 / 10 秒**。
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | — | 固定 `Omni-Flash-Ext` |
+| `prompt` | string | 必填 | — | 建议详细描述场景、人物、动作、环境、镜头运动、画面风格和**音频提示** |
+| `duration` | integer | 可选 | `6` | **仅支持 `4`、`6`、`8`、`10`**；传 5、7 等返回 `invalid_duration`。**传入 `video_urls` 时不需要也不能同时传 `duration`** |
+| `resolution` | string | 可选 | `720p` | `720p` / `1080p` / `4k`（**不区分大小写**）；其它返回 `invalid_resolution` |
+| `aspect_ratio` | string | 可选 | `16:9` | `16:9` / `9:16` |
+| `size` | string | 可选 | — | 兼容字段，含义同 `aspect_ratio`；同时传入时建议保持一致 |
+| `generation_type` | string | 可选 | — | `frame`（首帧模式，`image_urls` **只能 1 张**）/ `reference`（参考模式，`image_urls` **可 1 张或 3 张**） |
+| `image_urls` | array | 可选 | — | 可不传（文生视频）/ 1 张（单图生视频）/ 3 张（参考图融合，仅 `generation_type=reference`）。**不支持 2 张图的首尾帧模式**，传 2 张返回 `unsupported_image_count`；4 张及以上未实测验证，不建议使用。只支持公网可访问 URL |
+| `video_urls` | array | 可选 | — | **0 或 1 个**参考视频；2 个及以上返回 `unsupported_video_count`。**可与 `image_urls` 同时传入**（图片作身份/构图参考，视频作动态参考）。只支持公网 HTTP/HTTPS URL |
+| `nsfw_check` | boolean | 可选 | `false` | 提交前内容审核 |
+
+### 错误码
+
+| HTTP | 错误类型 | 含义 | 处理建议 |
+|---|---|---|---|
+| 400 | `invalid_request_error` | `model` 不是 `Omni-Flash-Ext`、`prompt` 为空或 JSON 格式错误 | 检查请求体 |
+| 400 | `invalid_duration` | `duration` 不是 4/6/8/10 | 改成支持的时长 |
+| 400 | `invalid_resolution` | `resolution` 不是 720p/1080p/4k | 改成支持的分辨率 |
+| 400 | `unsupported_image_count` | `image_urls` 数量不受支持（常见于传 2 张） | 改成 0、1 或 3 张 |
+| 400 | `unsupported_video_count` | `video_urls` 传了 2 个及以上 | 改成 0 或 1 个 |
+| 401 | `authentication_error` | Token 无效 | 检查 Bearer Token |
+| 402 | `payment_required` | 余额不足 | 充值后重试 |
+| 429 | `rate_limit_error` | 触发限流 | 降低并发或稍后重试 |
+
+任务失败时，任务查询接口在 `data.error` 返回失败原因，常见为上游配额暂时耗尽、内容审核未通过或上游超时。
+
+### 价格（`OMNI-FLASH-EXT`）
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)（2026-08-22，**16 个档位，按次计费**，1 Credit ≈ $0.1）。
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 默认 | 3.5 Credits/次 ≈ **$0.35/次** | $0.4375 | 20% |
+| 720P-4S | 2.5 ≈ **$0.25/次** | $0.3125 | 20% |
+| 720P-6S | 3 ≈ **$0.3/次** | $0.375 | 20% |
+| 720P-8S | 3.5 ≈ **$0.35/次** | $0.4375 | 20% |
+| 720P-10S | 4 ≈ **$0.4/次** | $0.5 | 20% |
+| 720P-VIDREF | 0.8 ≈ **$0.08/次** | $0.1 | 20% |
+| 1080P-4S | 2.5 ≈ **$0.25/次** | $0.3125 | 20% |
+| 1080P-6S | 3 ≈ **$0.3/次** | $0.375 | 20% |
+| 1080P-8S | 3.5 ≈ **$0.35/次** | $0.4375 | 20% |
+| 1080P-10S | 4 ≈ **$0.4/次** | $0.5 | 20% |
+| 1080P-VIDREF | 0.8 ≈ **$0.08/次** | $0.1 | 20% |
+| 4K-4S | 7.5 ≈ **$0.75/次** | $0.9375 | 20% |
+| 4K-6S | 8 ≈ **$0.8/次** | $1 | 20% |
+| 4K-8S | 8.5 ≈ **$0.85/次** | $1.0625 | 20% |
+| 4K-10S | 9 ≈ **$0.9/次** | $1.125 | 20% |
+| 4K-VIDREF | 2.4 ≈ **$0.24/次** | $0.3 | 20% |
+
+> **按次计费**（不是按秒），且 720P 与 1080P 同价；`VIDREF`（有参考视频）档位便宜很多。
+
+## 4. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 这两条渠道都没有这两个字段。
+- **两条渠道差异极大**：官方渠道只有 720p、时长 3–10 秒、参考图最多 16 张、支持 `extend_from_task_id` 多轮编辑；Ext 渠道有 1080p/4k、时长只能 4/6/8/10、参考图只能 0/1/3 张、没有多轮编辑。产品入口可以合并，但渠道选择必须驱动参数显隐、校验、请求、轮询与计价，不能把两套契约混用。
+- `extend_from_task_id`（多轮延续）需要填供应商侧的上一次任务 ID，本应用界面不展示任务 ID、用户拿不到：当前**不注册、不下发**（界面计划 5.8，P-17）。以后要支持，应做成生成记录上的“继续编辑”动作，由应用自己带上任务 ID，而不是参数输入框。
+- Ext 渠道**不支持 2 张图的首尾帧**——这是与几乎所有其他视频模型都不同的限制，UI 必须挡住。
+- Ext 渠道传参考视频时**不能同时传 `duration`**。
+- 官方渠道传 `video_urls` 后 `aspect_ratio` 失效。
+- Ext 渠道按次计费，时长与分辨率决定档位，成本估算逻辑与「按秒」模型完全不同。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：EXT 渠道带参考视频时不发送 duration，时长参数隐藏；“生成方式”只决定图片用法，不带图时隐藏。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Gemini Omni Flash 视频生成（官方渠道） | https://docs.apimart.ai/cn/api-reference/videos/gemini-omni-flash-preview/generation | 否 |
+| Omni-Flash-Ext 视频生成 | https://docs.apimart.ai/cn/api-reference/videos/omni-flash-ext/generation | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（视频标签页搜 GEMINI-OMNI-FLASH-PREVIEW / OMNI-FLASH-EXT） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |
+
+## 2026-10-12 Ext 与 preview 分支复核
+
+Ext 的 API model 固定为 `gemini-omni-1.1-flash-ext`，360p/720p/1080p/4k，360p 的 4/6/8/10 秒为 USD 0.15/0.175/0.20/0.225；输入参考视频 360p USD 0.04。Ext 图片仍只支持 0/1/3 张，frame 只能 1 张；视频最多 1 个，传视频不能同时传 duration。Preview 独立契约最多 16 张参考图，不能共享 Ext 的 3 张上限。Ext 页标题与错误表遗漏 360p，但字段正文明确列举且价格页有收费，以字段正文及现价为准。来源：[Ext](https://docs.apimart.ai/cn/api-reference/videos/omni-flash-ext/generation.md)、[preview](https://docs.apimart.ai/cn/api-reference/videos/gemini-omni-flash-preview/generation.md)、[价格](https://apimart.ai/zh/pricing)（公开无需登录）。