@henjicc/ai-sdk 0.8.0 → 0.10.0

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

@@ -1,84 +1,84 @@
-# Gemini Omni Flash · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | fal.ai（聚合平台） |
-| 平台模型 ID | `google/gemini-omni-flash/image-to-video`、`google/gemini-omni-flash/reference-to-video` |
-| 接口形态 | 队列异步（推荐）或同步直连 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> **Fal 上没有 `google/gemini-omni-flash/text-to-video` 端点**（2026-08-22 实测返回 404）。纯文生视频只能走 APIMart 或 KIE。
-
-## 1. 接入协议（Fal 通用）
-
-- **鉴权**：`Authorization: Key $FAL_KEY`
-- **同步**：`POST https://fal.run/<endpoint-id>`；**队列**：`POST https://queue.fal.run/<endpoint-id>`，`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）、`GET .../requests/{id}`
-- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
-
-## 2. 能力清单
-
-| 能力 | endpoint id |
-|---|---|
-| 图生视频 | `google/gemini-omni-flash/image-to-video` |
-| 参考生视频（多参考图） | `google/gemini-omni-flash/reference-to-video` |
-
-## 3. 请求参数
-
-### 3.1 `google/gemini-omni-flash/image-to-video`
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | **必填** | — | 描述图片应如何被动画化 |
-| `image_url` | string | **必填** | — | 待动画化的输入图 URL |
-| `aspect_ratio` | string | 可选 | `16:9` | **仅 `16:9` / `9:16`** |
-| `duration` | integer | 可选 | **`8`** | **3 ~ 10 秒**（整数，注意 APIMart Ext / KIE 只允许 4/6/8/10） |
-
-### 3.2 `google/gemini-omni-flash/reference-to-video`
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | **必填** | — | 视频描述。**可用 `<IMAGE_REF_0>` 这样的标签把参考图内联绑定到角色**（见 Fal 的 Omni Flash prompt guide） |
-| `image_urls` | string[] | **必填** | — | 要融入视频的参考图 URL 列表 |
-| `aspect_ratio` | string | 可选 | `16:9` | `16:9` / `9:16` |
-| `duration` | integer | 可选 | `8` | 3 ~ 10 秒 |
-
-## 4. 响应结构
-
-```json
-{ "video": { "url": "https://v3b.fal.media/files/.../output.mp4" } }
-```
-
-## 5. 价格（按 token）
-
-来源：两个端点的 `llms.txt`（2026-08-22 读取）。
-
-| 计费项 | 单价 |
-|---|---|
-| 输入 token（文本 / 音频 / 视频） | **$1.875 / 1M tokens** |
-| 输出 token | **$21.875 / 1M tokens** |
-
-**720p 视频约合 $0.13 / 秒。**
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点两个字段都没有。
-- **Fal 没有纯文生视频端点**，产品若要文生视频必须走别的供应商。
-- **`duration` 是整数且支持 3–10 的连续取值**，默认 8；而 APIMart 的 Ext 渠道与 KIE 都只允许 4/6/8/10——跨供应商的时长选项必须分别裁剪。
-- `aspect_ratio` 只有横竖两种，没有 1:1。
-- 参考图的角色绑定用 `<IMAGE_REF_0>` 标签，与 APIMart 官方渠道（自然语言描述）、KIE（character_ids 资产）都不同。
-- 按 token 计费，成本估算不能按次或按秒简单换算。
-- Fal 上没有 KIE 那套语音 / 角色资产端点。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 图生视频模型页 | https://fal.ai/models/google/gemini-omni-flash/image-to-video | 否 |
-| 图生视频 schema + 价格 | https://fal.ai/models/google/gemini-omni-flash/image-to-video/llms.txt | 否 |
-| 参考生视频模型页 | https://fal.ai/models/google/gemini-omni-flash/reference-to-video | 否 |
-| 参考生视频 schema + 价格 | https://fal.ai/models/google/gemini-omni-flash/reference-to-video/llms.txt | 否 |
-| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
-| API Key 创建 | https://fal.ai/dashboard/keys | **是** |
+# Gemini Omni Flash · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `google/gemini-omni-flash/image-to-video`、`google/gemini-omni-flash/reference-to-video` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> **Fal 上没有 `google/gemini-omni-flash/text-to-video` 端点**（2026-08-22 实测返回 404）。纯文生视频只能走 APIMart 或 KIE。
+
+## 1. 接入协议（Fal 通用）
+
+- **鉴权**：`Authorization: Key $FAL_KEY`
+- **同步**：`POST https://fal.run/<endpoint-id>`；**队列**：`POST https://queue.fal.run/<endpoint-id>`，`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）、`GET .../requests/{id}`
+- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
+
+## 2. 能力清单
+
+| 能力 | endpoint id |
+|---|---|
+| 图生视频 | `google/gemini-omni-flash/image-to-video` |
+| 参考生视频（多参考图） | `google/gemini-omni-flash/reference-to-video` |
+
+## 3. 请求参数
+
+### 3.1 `google/gemini-omni-flash/image-to-video`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | **必填** | — | 描述图片应如何被动画化 |
+| `image_url` | string | **必填** | — | 待动画化的输入图 URL |
+| `aspect_ratio` | string | 可选 | `16:9` | **仅 `16:9` / `9:16`** |
+| `duration` | integer | 可选 | **`8`** | **3 ~ 10 秒**（整数，注意 APIMart Ext / KIE 只允许 4/6/8/10） |
+
+### 3.2 `google/gemini-omni-flash/reference-to-video`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | **必填** | — | 视频描述。**可用 `<IMAGE_REF_0>` 这样的标签把参考图内联绑定到角色**（见 Fal 的 Omni Flash prompt guide） |
+| `image_urls` | string[] | **必填** | — | 要融入视频的参考图 URL 列表 |
+| `aspect_ratio` | string | 可选 | `16:9` | `16:9` / `9:16` |
+| `duration` | integer | 可选 | `8` | 3 ~ 10 秒 |
+
+## 4. 响应结构
+
+```json
+{ "video": { "url": "https://v3b.fal.media/files/.../output.mp4" } }
+```
+
+## 5. 价格（按 token）
+
+来源：两个端点的 `llms.txt`（2026-08-22 读取）。
+
+| 计费项 | 单价 |
+|---|---|
+| 输入 token（文本 / 音频 / 视频） | **$1.875 / 1M tokens** |
+| 输出 token | **$21.875 / 1M tokens** |
+
+**720p 视频约合 $0.13 / 秒。**
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点两个字段都没有。
+- **Fal 没有纯文生视频端点**，产品若要文生视频必须走别的供应商。
+- **`duration` 是整数且支持 3–10 的连续取值**，默认 8；而 APIMart 的 Ext 渠道与 KIE 都只允许 4/6/8/10——跨供应商的时长选项必须分别裁剪。
+- `aspect_ratio` 只有横竖两种，没有 1:1。
+- 参考图的角色绑定用 `<IMAGE_REF_0>` 标签，与 APIMart 官方渠道（自然语言描述）、KIE（character_ids 资产）都不同。
+- 按 token 计费，成本估算不能按次或按秒简单换算。
+- Fal 上没有 KIE 那套语音 / 角色资产端点。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 图生视频模型页 | https://fal.ai/models/google/gemini-omni-flash/image-to-video | 否 |
+| 图生视频 schema + 价格 | https://fal.ai/models/google/gemini-omni-flash/image-to-video/llms.txt | 否 |
+| 参考生视频模型页 | https://fal.ai/models/google/gemini-omni-flash/reference-to-video | 否 |
+| 参考生视频 schema + 价格 | https://fal.ai/models/google/gemini-omni-flash/reference-to-video/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

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

@@ -1,129 +1,132 @@
-# Gemini Omni Flash · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频（配套语音与角色能力） |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID / 端点 | `gemini-omni-video`（任务）、`POST /api/v1/omni/audio/create`、`POST /api/v1/omni/character/create` |
-| 接口形态 | 视频走**异步任务**；语音与角色是**独立的同步创建端点** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> ⚠️ KIE 的 Gemini Omni 是**三个端点组成的一套体系**：先用 `omni/audio/create` 造语音、用 `omni/character/create` 造角色，再把拿到的 `audio_ids` / `character_ids` 喂给 `gemini-omni-video`。上一版适配只做了视频生成，**语音与角色两块完全遗漏**。
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.kie.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **视频提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "gemini-omni-video", callBackUrl?, input }`
-- **视频查询**：`GET /api/v1/jobs/recordInfo?taskId=...`，`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
-- **语音创建**：`POST /api/v1/omni/audio/create`
-- **角色创建**：`POST /api/v1/omni/character/create`
-
-## 2. 端点 A：`gemini-omni-video`（多模态视频生成）
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | **必填** | — | 视频提示词，最多 **20000** 字符。描述画面内容、风格、镜头语言或角色行为 |
-| `input.image_urls` | array | 可选 | — | 参考图片。单个文件 ≤ **20 MB**；须公开可访问；**最多 7 张** |
-| `input.audio_ids` | array | 可选 | — | 由 **`gemini-omni-audio`** 接口生成的音频 ID 数组，用于旁白 / 对白 / 配乐 / 声音参考。**最多 3 个** |
-| `input.video_list` | array | 可选 | — | 视频片段数组。**最多 1 个，且占用 2 张图片额度**。每项 `{ url, start, ends }`：单个文件 ≤ **100 MB**、视频时长 ≤ **30 s**、`ends > start` 且 **`ends - start` ≤ 10 s** |
-| `input.character_ids` | array | 可选 | — | 由 **`gemini-omni-character`** 接口生成的角色 ID 数组。**每个 `character_id` 占用 1 个 image slot；基础最多 7 个；若同时传 `video_list`（占 2 个 slot），`character_ids` 最多 3 个** |
-| `input.duration` | string | **必填** | — | **`"4"` / `"6"` / `"8"` / `"10"`（字符串）**。**仅在无视频输入时生效**；有视频输入时输出时长由模型决定，本参数被忽略 |
-| `input.aspect_ratio` | string | 可选 | — | `16:9`（横屏）/ `9:16`（竖屏） |
-| `input.seed` | integer | 可选 | 自动 | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
-| `input.resolution` | string | 可选 | `720p` | `720p` / `1080p` / `4k` |
-
-### image slot 计算（关键约束）
-
-图片额度总共 **7 个 slot**，被以下三者共同占用：
-- 每张 `image_urls` 图片：1 slot
-- 每个 `character_ids`：1 slot
-- `video_list`（最多 1 个）：**2 slot**
-
-因此有视频输入时，`character_ids` 最多 3 个。UI 计数必须按这个规则统一算。
-
-## 3. 端点 B：`POST /api/v1/omni/audio/create`（生语音）
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `audio_id` | string | **必填** | 预设语音角色枚举（30 个，见下） |
-| `name` | string | **必填** | 语音名称，最长 **210** 字符 |
-| `voice_description` | string | 可选 | 语音特征描述（音色、风格、语速、情绪），最长 **20000** 字符 |
-| `example_dialogue` | string | 可选 | 对话示例（如「你好,我是Adam」），最长 **120** 字符 |
-
-### `audio_id` 预设音色全表
-
-| ID | 描述 | ID | 描述 |
-|---|---|---|---|
-| `achernar` | 女声，柔和，高音调 | `laomedeia` | 女声，欢快，中高音调 |
-| `achird` | 男声，友好，中音调 | `leda` | 女声，年轻，中高音调 |
-| `algenib` | 男声，沙哑，低音调 | `orus` | 男声，沉稳，中低音调 |
-| `algieba` | 男声，随和，中低音调 | `puck` | 男声，欢快，中音调 |
-| `alnilam` | 男声，沉稳，中低音调 | `pulcherrima` | 无性别，前置感，中高音调 |
-| `aoede` | 女声，轻快，中音调 | `rasalgethi` | 男声，知性，中音调 |
-| `autonoe` | 女声，明亮，中音调 | `sadachbia` | 男声，生动，低音调 |
-| `callirrhoe` | 女声，随和，中音调 | `sadaltager` | 男声，博学，中音调 |
-| `charon` | 男声，知性，低音调 | `schedar` | 男声，平稳，中低音调 |
-| `despina` | 女声，流畅，中音调 | `sulafat` | 女声，温暖，中音调 |
-| `enceladus` | 男声，气声，低音调 | `umbriel` | 男声，流畅，低音调 |
-| `erinome` | 女声，清晰，中音调 | `vindemiatrix` | 女声，温柔，中音调 |
-| `fenrir` | 男声，活泼，偏年轻音调 | `zephyr` | 女声，明亮，中高音调 |
-| `gacrux` | 女声，成熟，中音调 | `zubenelgenubi` | 男声，随性，中低音调 |
-| `iapetus` | 男声，清晰，中低音调 | `kore` | 女声，干练，中音调 |
-
-## 4. 端点 C：`POST /api/v1/omni/character/create`（生角色）
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `descriptions` | string | **必填** | 角色描述：外观、身份、风格、服饰或性格设定 |
-| `image_urls` | array | **必填** | 角色参考图，**仅支持 1 张**。单张 ≤ **20 MB**，须公开可访问 |
-| `audio_ids` | array | 可选 | 由 `gemini-omni-audio` 生成的音频 ID，用于补充声音特征、语气或人设参考 |
-| `character_name` | string | 可选 | 角色名称 |
-
-## 5. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `gemini-omni`；1 Credit = $0.005）。**按次（per video）计费，不是按秒。**
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
-|---|---|---|---|---|
-| 720p 4s 无视频输入 | 63 /条 | **$0.315/条** | $0.5 | 37.0% |
-| 720p 6s 无视频输入 | 84 /条 | **$0.42/条** | $0.75 | 44.0% |
-| 720p 8s 无视频输入 | 105 /条 | **$0.525/条** | $1 | 47.5% |
-| 720p 10s 无视频输入 | 126 /条 | **$0.63/条** | $1.25 | 49.6% |
-| 1080p 4s 无视频输入 | 63 /条 | **$0.315/条** | N/A | — |
-| 1080p 6s 无视频输入 | 84 /条 | **$0.42/条** | N/A | — |
-| 1080p 8s 无视频输入 | 105 /条 | **$0.525/条** | N/A | — |
-| 1080p 10s 无视频输入 | 126 /条 | **$0.63/条** | N/A | — |
-| 4k 4s 无视频输入 | 147 /条 | **$0.735/条** | N/A | — |
-| 4k 6s 无视频输入 | 168 /条 | **$0.84/条** | N/A | — |
-| 4k 8s 无视频输入 | 189 /条 | **$0.945/条** | N/A | — |
-| 4k 10s 无视频输入 | 210 /条 | **$1.05/条** | N/A | — |
-| 720p 有视频输入 | 168 /条 | **$0.84/条** | N/A | — |
-| 1080p 有视频输入 | 168 /条 | **$0.84/条** | N/A | — |
-| 4k 有视频输入 | 252 /条 | **$1.26/条** | N/A | — |
-
-定价页未列出 `omni/audio/create` 与 `omni/character/create` 的价格，接入前需确认这两个端点是否单独计费。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 的 `gemini-omni-video` **有 `seed`**，必须主动不注册、不下发。
-- **这是一套三端点体系**，语音与角色是可复用资产（先创建拿 ID，再在视频里引用），需要独立的资产管理交互，不能塞进单次生成的参数面板。
-- **image slot 是共享额度**（图片 1 / 角色 1 / 视频 2，总计 7），前端计数必须统一。
-- `duration` 是**字符串**且只有 4/6/8/10；**有视频输入时该参数静默失效**。
-- **按次计费**：720p 与 1080p 同价，4k 更贵；有视频输入时价格固定且明显更高。
-- `video_list` 的截取窗口 `ends - start` 必须 ≤ 10 秒。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Gemini Omni 生视频 | https://docs.kie.ai/cn/market/gemini-omni-video | 否 |
-| Gemini Omni Audio 生语音 | https://docs.kie.ai/cn/market/gemini-omni-audio | 否 |
-| Gemini Omni Character 生角色 | https://docs.kie.ai/cn/market/gemini-omni-character | 否 |
-| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `gemini-omni`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Gemini Omni Flash · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频（配套语音与角色能力） |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID / 端点 | `gemini-omni-video`（任务）、`POST /api/v1/omni/audio/create`、`POST /api/v1/omni/character/create` |
+| 接口形态 | 视频走**异步任务**；语音与角色是**独立的同步创建端点** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> ⚠️ KIE 的 Gemini Omni 是**三个端点组成的一套体系**：先用 `omni/audio/create` 造语音、用 `omni/character/create` 造角色，再把拿到的 `audio_ids` / `character_ids` 喂给 `gemini-omni-video`。上一版适配只做了视频生成，**语音与角色两块完全遗漏**。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **视频提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "gemini-omni-video", callBackUrl?, input }`
+- **视频查询**：`GET /api/v1/jobs/recordInfo?taskId=...`，`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
+- **语音创建**：`POST /api/v1/omni/audio/create`
+- **角色创建**：`POST /api/v1/omni/character/create`
+
+## 2. 端点 A：`gemini-omni-video`（多模态视频生成）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | **必填** | — | 视频提示词，最多 **20000** 字符。描述画面内容、风格、镜头语言或角色行为 |
+| `input.image_urls` | array | 可选 | — | 参考图片。单个文件 ≤ **20 MB**；须公开可访问；**最多 7 张** |
+| `input.audio_ids` | array | 可选 | — | 由 **`gemini-omni-audio`** 接口生成的音频 ID 数组，用于旁白 / 对白 / 配乐 / 声音参考。**最多 3 个** |
+| `input.video_list` | array | 可选 | — | 视频片段数组。**最多 1 个，且占用 2 张图片额度**。每项 `{ url, start, ends }`：单个文件 ≤ **100 MB**、视频时长 ≤ **30 s**、`ends > start` 且 **`ends - start` ≤ 10 s** |
+| `input.character_ids` | array | 可选 | — | 由 **`gemini-omni-character`** 接口生成的角色 ID 数组。**每个 `character_id` 占用 1 个 image slot；基础最多 7 个；若同时传 `video_list`（占 2 个 slot），`character_ids` 最多 3 个** |
+| `input.duration` | string | **必填** | — | **`"4"` / `"6"` / `"8"` / `"10"`（字符串）**。**仅在无视频输入时生效**；有视频输入时输出时长由模型决定，本参数被忽略 |
+| `input.aspect_ratio` | string | 可选 | — | `16:9`（横屏）/ `9:16`（竖屏） |
+| `input.seed` | integer | 可选 | 自动 | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
+| `input.resolution` | string | 可选 | `720p` | `720p` / `1080p` / `4k` |
+
+### image slot 计算（关键约束）
+
+图片额度总共 **7 个 slot**，被以下三者共同占用：
+- 每张 `image_urls` 图片：1 slot
+- 每个 `character_ids`：1 slot
+- `video_list`（最多 1 个）：**2 slot**
+
+因此有视频输入时，`character_ids` 最多 3 个。UI 计数必须按这个规则统一算。
+
+## 3. 端点 B：`POST /api/v1/omni/audio/create`（生语音）
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `audio_id` | string | **必填** | 预设语音角色枚举（30 个，见下） |
+| `name` | string | **必填** | 语音名称，最长 **210** 字符 |
+| `voice_description` | string | 可选 | 语音特征描述（音色、风格、语速、情绪），最长 **20000** 字符 |
+| `example_dialogue` | string | 可选 | 对话示例（如「你好,我是Adam」），最长 **120** 字符 |
+
+### `audio_id` 预设音色全表
+
+| ID | 描述 | ID | 描述 |
+|---|---|---|---|
+| `achernar` | 女声，柔和，高音调 | `laomedeia` | 女声，欢快，中高音调 |
+| `achird` | 男声，友好，中音调 | `leda` | 女声，年轻，中高音调 |
+| `algenib` | 男声，沙哑，低音调 | `orus` | 男声，沉稳，中低音调 |
+| `algieba` | 男声，随和，中低音调 | `puck` | 男声，欢快，中音调 |
+| `alnilam` | 男声，沉稳，中低音调 | `pulcherrima` | 无性别，前置感，中高音调 |
+| `aoede` | 女声，轻快，中音调 | `rasalgethi` | 男声，知性，中音调 |
+| `autonoe` | 女声，明亮，中音调 | `sadachbia` | 男声，生动，低音调 |
+| `callirrhoe` | 女声，随和，中音调 | `sadaltager` | 男声，博学，中音调 |
+| `charon` | 男声，知性，低音调 | `schedar` | 男声，平稳，中低音调 |
+| `despina` | 女声，流畅，中音调 | `sulafat` | 女声，温暖，中音调 |
+| `enceladus` | 男声，气声，低音调 | `umbriel` | 男声，流畅，低音调 |
+| `erinome` | 女声，清晰，中音调 | `vindemiatrix` | 女声，温柔，中音调 |
+| `fenrir` | 男声，活泼，偏年轻音调 | `zephyr` | 女声，明亮，中高音调 |
+| `gacrux` | 女声，成熟，中音调 | `zubenelgenubi` | 男声，随性，中低音调 |
+| `iapetus` | 男声，清晰，中低音调 | `kore` | 女声，干练，中音调 |
+
+## 4. 端点 C：`POST /api/v1/omni/character/create`（生角色）
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `descriptions` | string | **必填** | 角色描述：外观、身份、风格、服饰或性格设定 |
+| `image_urls` | array | **必填** | 角色参考图，**仅支持 1 张**。单张 ≤ **20 MB**，须公开可访问 |
+| `audio_ids` | array | 可选 | 由 `gemini-omni-audio` 生成的音频 ID，用于补充声音特征、语气或人设参考 |
+| `character_name` | string | 可选 | 角色名称 |
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `gemini-omni`；1 Credit = $0.005）。**按次（per video）计费，不是按秒。**
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 720p 4s 无视频输入 | 63 /条 | **$0.315/条** | $0.5 | 37.0% |
+| 720p 6s 无视频输入 | 84 /条 | **$0.42/条** | $0.75 | 44.0% |
+| 720p 8s 无视频输入 | 105 /条 | **$0.525/条** | $1 | 47.5% |
+| 720p 10s 无视频输入 | 126 /条 | **$0.63/条** | $1.25 | 49.6% |
+| 1080p 4s 无视频输入 | 63 /条 | **$0.315/条** | N/A | — |
+| 1080p 6s 无视频输入 | 84 /条 | **$0.42/条** | N/A | — |
+| 1080p 8s 无视频输入 | 105 /条 | **$0.525/条** | N/A | — |
+| 1080p 10s 无视频输入 | 126 /条 | **$0.63/条** | N/A | — |
+| 4k 4s 无视频输入 | 147 /条 | **$0.735/条** | N/A | — |
+| 4k 6s 无视频输入 | 168 /条 | **$0.84/条** | N/A | — |
+| 4k 8s 无视频输入 | 189 /条 | **$0.945/条** | N/A | — |
+| 4k 10s 无视频输入 | 210 /条 | **$1.05/条** | N/A | — |
+| 720p 有视频输入 | 168 /条 | **$0.84/条** | N/A | — |
+| 1080p 有视频输入 | 168 /条 | **$0.84/条** | N/A | — |
+| 4k 有视频输入 | 252 /条 | **$1.26/条** | N/A | — |
+
+定价页未列出 `omni/audio/create` 与 `omni/character/create` 的价格，接入前需确认这两个端点是否单独计费。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 的 `gemini-omni-video` **有 `seed`**，必须主动不注册、不下发。
+- **这是一套三端点体系**，语音与角色是可复用资产（先创建拿 ID，再在视频里引用），需要独立的资产管理交互，不能塞进单次生成的参数面板。
+- 当前状态（界面计划 5.8，P-17）：应用还没有语音 / 角色资产的创建与管理入口，用户拿不到 `audio_ids` / `character_ids`，所以这两个字段**不注册、不下发**；参考图上限按“无视频 7 张、有视频 5 张”校验。
+- **image slot 是共享额度**（图片 1 / 角色 1 / 视频 2，总计 7），前端计数必须统一。
+- `duration` 是**字符串**且只有 4/6/8/10；**有视频输入时该参数静默失效**。
+- **按次计费**：720p 与 1080p 同价，4k 更贵；有视频输入时价格固定且明显更高。
+- `video_list` 的截取窗口 `ends - start` 必须 ≤ 10 秒。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+- 官方格式核对（2026-11-08）：官方 OpenAPI 把 `duration` 列为必填，带参考视频时官方忽略它：界面隐藏时长，请求固定发 `"8"`。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Gemini Omni 生视频 | https://docs.kie.ai/cn/market/gemini-omni-video | 否 |
+| Gemini Omni Audio 生语音 | https://docs.kie.ai/cn/market/gemini-omni-audio | 否 |
+| Gemini Omni Character 生角色 | https://docs.kie.ai/cn/market/gemini-omni-character | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `gemini-omni`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Grok-Imagine/Grok-Imagine_KIE.md

@@ -1,36 +1,38 @@
-# Grok Imagine · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 图片 |
-| 供应商 | KIE.ai |
-| 平台模型 ID | `grok-imagine/text-to-image`、`grok-imagine/image-to-image` |
-| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 模式
-
-- 文生图使用 `grok-imagine/text-to-image`，`enable_pro=false` 是 Standard，`enable_pro=true` 是 Quality。
-- 图生图使用 `grok-imagine/image-to-image`，输入 1 张图片。
-
-## 2. 价格与输出单位
-
-KIE 定价使用 `1 Credit = $0.005`。
-
-| 模式 | Credits | 总价 | 计价输出单位 |
-|---|---:|---:|---|
-| Standard 文生图 | 4 / 次 | $0.02 / 次 | 2 张图 |
-| Quality 文生图 | 5 / 次 | $0.025 / 次 | **4 张图** |
-| 图生图 | 4 / 张 | $0.02 / 张 | 1 张图 |
-
-SDK calculator 返回的是整次请求价格：Quality 仍是 `$0.025`，但说明必须写明该次输出 4 张，不能写成 2 张。
-
-## 3. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| Grok Imagine 文生图 | https://docs.kie.ai/cn/market/grok-imagine/text-to-image | 否 |
-| Grok Imagine 图生图 | https://docs.kie.ai/cn/market/grok-imagine/image-to-image | 否 |
-| 模型专页 | https://kie.ai/grok-imagine | 否 |
-| 当前定价 | https://kie.ai/pricing | 否 |
+# Grok Imagine · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai |
+| 平台模型 ID | `grok-imagine/text-to-image`、`grok-imagine/image-to-image` |
+| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 模式
+
+- 文生图使用 `grok-imagine/text-to-image`，`enable_pro=false` 是 Standard，`enable_pro=true` 是 Quality。
+- 图生图使用 `grok-imagine/image-to-image`，输入 1 张图片。
+
+## 2. 价格与输出单位
+
+KIE 定价使用 `1 Credit = $0.005`。
+
+| 模式 | Credits | 总价 | 计价输出单位 |
+|---|---:|---:|---|
+| Standard 文生图 | 4 / 次 | $0.02 / 次 | 2 张图 |
+| Quality 文生图 | 5 / 次 | $0.025 / 次 | **4 张图** |
+| 图生图 | 4 / 张 | $0.02 / 张 | 1 张图 |
+
+SDK calculator 返回的是整次请求价格：Quality 仍是 `$0.025`，但说明必须写明该次输出 4 张，不能写成 2 张。
+
+- 官方格式核对（2026-11-08）：图生图接口没有 `aspect_ratio`（官方 OpenAPI），不再发送，比例参数在图生图时隐藏。
+
+## 3. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Grok Imagine 文生图 | https://docs.kie.ai/cn/market/grok-imagine/text-to-image | 否 |
+| Grok Imagine 图生图 | https://docs.kie.ai/cn/market/grok-imagine/image-to-image | 否 |
+| 模型专页 | https://kie.ai/grok-imagine | 否 |
+| 当前定价 | https://kie.ai/pricing | 否 |