@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Grsai.md

@@ -0,0 +1,53 @@
+# GPT Image 2.5 · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 模型 | gpt-image-2.5 / gpt-image-2.5-flare / gpt-image-2.5-sunburst |
+| 文档/价格 | 公开无需登录；模型页已核对充值档位 |
+| 价格 | 600 / 2000 / 2400积分每次；基础充值档分别¥0.06 / ¥0.20 / ¥0.24 |
+
+公告中的¥0.03 / ¥0.10 / ¥0.12基于¥999充值档每元20000积分；¥10档每元10000积分。SDK延续基础档无优惠上限口径，不能直接把公告优惠价作为所有用户价格。
+2026-09-10公告将Flare/Sunburst从3000积分分别降到2000/2400。旧2标准/VIP为600/2000积分：2.5标准及Flare与旧对应渠道同价，Sunburst更贵。
+
+## 请求
+
+全球 `https://grsaiapi.com`，国内 `https://grsai.dakka.com.cn`；Bearer API Key。
+JSON `POST /v1/api/generate`；共享provider固定`replyType=async`，查询`GET /v1/api/result?id=...`。
+
+| 字段 | 类型 | 约束 |
+|---|---|---|
+| model | string，必填 | 上述三个ID |
+| prompt | string，必填 | 提示词 |
+| images | string[]，可选 | URL/base64；官方未给张数上限，应用保留16张本地上限，不宣称官方限制 |
+| aspectRatio | string | 标准2.5仅1K，比例或1K像素；Flare/Sunburst必须像素，不能比例 |
+| quality | string，可选 | 标准只auto；Flare low/medium/high；Sunburst另支持xhigh/max |
+| background | string，可选 | 只有Flare/Sunburst支持transparent；关闭时省略 |
+| replyType | string | json/stream/async；SDK采用async |
+
+默认Flare、智能比例、1K、medium；版本显式选择标准/Flare/Sunburst。
+标准隐藏分辨率、质量、背景；不把标准渠道映射为Flare，因为官方未确认底层型号。
+无图/有图同接口自动生成/编辑。图片使用既有主进程媒体预处理，不提供URL文本框。
+没有imageSize、n、output_format，不发送。参考尺寸完全采用当前Grsai字段表；1:3/3:1官方只给1K与4K，2K不展示、不静默降至1K。
+Flare/Sunburst像素最大边3840、16倍数、长宽比≤3、面积655360–8294400。
+文档quality总列表和逐模型说明不同，采用更具体的逐模型表；旧示例model=2却background=transparent，与字段说明冲突，原样保存但不作为2.5请求范本。
+
+## 事件契约
+
+| 状态 | 前置 | 字段/空值语义 | 下一状态/输出 | 终态/副作用/复用 |
+|---|---|---|---|---|
+| running | 提交后 | id/status必需string；results未就绪可缺失，progress可选 | pending | 独立HTTP轮询 |
+| succeeded | pending | id/status必需；results[].url必须有有效值 | completed | 停止轮询 |
+| failed | 任意 | id/status/error，error说明失败 | provider_task_failed | 停止轮询，返积分 |
+| violation | 任意 | 同失败但独立状态 | provider_task_failed | 停止轮询，2.5返积分 |
+
+重复running合法；官方未说明乱序、断线续接、远端取消/连接复用。SDK取消/超时停止本地计时与网络，不保证远端撤销。空终态拒绝。
+官方字面响应与字段表保存至 `tests/fixtures/gpt-image-2.5/`；复用现有Grsai provider状态机测试，无付费真网证据。
+
+## 原始链接索引
+
+均公开无需登录：
+- [生成接口：模型、质量、透明背景、完整像素表](https://qmy27nhsd9.apifox.cn/452409160e0.md)
+- [轮询与错误响应](https://qmy27nhsd9.apifox.cn/452409577e0.md)
+- [实时模型积分及充值档位](https://grsai.ai/zh/dashboard/models)
+- [9月9日上新与9月10日降价公告](https://grsai.ai/zh/dashboard/announcements)

package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_KIE.md

@@ -0,0 +1,55 @@
+# GPT Image 2.5 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 模态 | 图片；独立于 GPT Image 2 保留 |
+| model ID | `gpt-image-2-5-{flare,sunburst}-{text-to-image,image-to-image}` |
+| 文档与价格 | 公开，无需登录；已实际展开模型页四个型号 |
+| 定价 | 两个版本、文生图/编辑均为 1K $0.03、2K $0.05、4K $0.08/张；不计充值赠送 |
+
+## 请求契约
+
+`https://api.kie.ai`，Bearer API Key；`POST /api/v1/jobs/createTask`，JSON `{model,input}`。
+`input.prompt` 必填，1–20000 字符；编辑分支额外必填 `input.input_urls: string[]`，最多16张。
+模型页限制参考图 JPEG/PNG/WebP/JPG，单文件30MB。媒体沿用 KIE 官方上传与 SDK 预处理。
+
+| input 字段 | 类型 | 值与约束 |
+|---|---|---|
+| aspect_ratio | string | auto、1:1、3:2、2:3、4:3、3:4、16:9、9:16、21:9、27:16、16:27、9:8、8:9 |
+| resolution | string | 1K、2K、4K；27:16、16:27、9:8、8:9 仅1K |
+| background | string | transparent、opaque、auto |
+
+版本显式选择 Flare/Sunburst；无图/有图自动选择文生图/编辑。应用默认 Flare、智能比例、1K、auto 背景。
+智能比例在本地按首图匹配合法比例，无图1:1；高分辨率时排除仅1K的比例。
+没有 quality、n、mask、output_format 字段，不从 OpenAI 或旧模型补入。
+`callBackUrl` 可选，项目使用轮询而不发送回调。
+
+## 事件与失败契约
+
+提交成功 `{code:200,msg:"success",data:{taskId}}`；`GET /api/v1/jobs/recordInfo?taskId=...` 查询。
+
+| 事件/状态 | 前置 | 字段与空值语义 | 下一状态/输出 | 终态与副作用/复用 |
+|---|---|---|---|---|
+| 提交 | 未提交 | data.taskId 必需非空 string | 保存taskId，pending | 开始轮询，HTTP独立请求 |
+| waiting | 提交后 | data.state string；未完成不得依赖resultJson | pending | 继续轮询 |
+| queuing | 提交后 | 同上 | pending | 继续轮询 |
+| generating | 提交后 | 同上 | pending | 继续轮询 |
+| success | pending | resultJson 为JSON字符串，图像结果在resultUrls数组；必须有有效URL | completed/images | 停止轮询 |
+| fail | pending | failCode/failMsg 提供原因 | provider_task_failed | 停止轮询 |
+| HTTP/API错误 | 任意请求 | 401/402/422/429等，以供应商错误为准 | 报错 | 不冒充成功 |
+
+官方没有明确保证状态严格有序、连接复用、断线恢复或远端取消。SDK允许重复处理中状态；取消/超时停止本地轮询并释放计时器，不保证撤销计费。空成功结果拒绝。复用既有 KIE provider 与轮询测试。
+查询文档的字面“成功”示例矛盾：`data.state=success` 却带 `code=505`。fixture 原样保留并验证不会返回成功；合成正例仅改为 `code=200`，明确不属于官方原样或真网日志。
+
+官方字段表与字面示例保存在 `tests/fixtures/gpt-image-2.5/`，合成负例单独标记；本次不代表付费真网验收。
+
+## 原始链接索引
+
+均已公开访问，无需登录：
+- [Flare 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-5-flare-text-to-image.md)
+- [Flare 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-5-flare-image-to-image.md)
+- [Sunburst 文生图](https://docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-text-to-image.md)
+- [Sunburst 编辑](https://docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-image-to-image.md)
+- [查询协议](https://docs.kie.ai/market/common/get-task-detail.md)
+- [模型页及实时价格](https://kie.ai/gpt-image-2-5)

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-Omni-Flash/Gemini-Omni-Flash_APIMart.md

@@ -1,124 +1,124 @@
-# 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 张、没有多轮编辑。产品入口可以合并，但渠道选择必须驱动参数显隐、校验、请求、轮询与计价，不能把两套契约混用。
-- 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-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 张、没有多轮编辑。产品入口可以合并，但渠道选择必须驱动参数显隐、校验、请求、轮询与计价，不能把两套契约混用。
+- 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 | **是** |