@henjicc/ai-sdk 0.8.0 → 0.10.0

package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_KIE.md

@@ -1,86 +1,87 @@
-# Seedance 2.0 · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | `bytedance/seedance-2` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.kie.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "bytedance/seedance-2", callBackUrl?, input }`
-- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
-- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`
-- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`；**开启 `return_last_frame` 时结构为 `{ resultUrls: [], firstFrameUrl: [], lastFrameUrl: [] }`**（KIE 通用任务详情文档明确说明）
-
-## 2. 能力清单
-
-KIE 把 Seedance 2.0 系列做成**单端点多能力**：有无首帧/尾帧/参考图/参考视频/参考音频，都在同一个 `model` 下靠字段区分。
-
-## 3. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 见说明 | — | 文本提示词。schema 标为可选但描述写「必填字段」，长度 3–**20000** 字符 |
-| `input.first_frame_url` | string | 可选 | — | 首帧图片地址，或 `asset://{assetId}` |
-| `input.last_frame_url` | string | 可选 | — | 尾帧图片地址，或 `asset://{assetId}` |
-| `input.reference_image_urls` | array | 可选 | — | 参考图，**最多 9 张**（**与首尾帧张数之和不得超过 9 张**）。格式 jpeg/png/webp/bmp/tiff/gif；宽高比 (0.4, 2.5)；边长 (300, 6000) px；单张 < 30 MB |
-| `input.reference_video_urls` | array | 可选 | — | 参考视频，**最多 3 个**。格式 mp4/mov；分辨率 480p/720p；单个时长 [2, 15] s 且总时长 ≤ 15 s；宽高比 [0.4, 2.5]；边长 [300, 6000] px；总像素 [409600 (640×640), 927408 (834×1112)]；单个 ≤ 50 MB；帧率 [24, 60] |
-| `input.reference_audio_urls` | array | 可选 | — | 参考音频，**最多 3 段**。格式 wav/mp3；单个时长 [2, 15] s 且总时长 ≤ 15 s；单个 ≤ 15 MB |
-| `input.return_last_frame` | boolean | 可选 | `false` | 是否返回视频最后一帧图片 |
-| `input.generate_audio` | boolean | 可选 | **`true`** | 是否生成与画面同步的音频 |
-| `input.resolution` | string | 可选 | `720p` | `480p` / `720p` / `1080p` / `4k` |
-| `input.aspect_ratio` | string | 可选 | `16:9` | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`21:9`、`adaptive` |
-| `input.duration` | integer | 可选 | `5` | **4–15 秒** |
-| `input.web_search` | boolean | 可选 | — | 是否启用联网搜索 |
-| `input.nsfw_checker` | boolean | 可选 | `false` | `false` 时关闭内容过滤，结果直接返回 |
-
-## 4. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)`：
-
-- 普通：`{ "resultUrls": ["https://....mp4"] }`
-- 开启 `return_last_frame`：`{ "resultUrls": [], "firstFrameUrl": [], "lastFrameUrl": [] }`
-
-## 5. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `seedance`；1 Credit = $0.005）。
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
-|---|---|---|---|---|
-| 480p no video input | 19 /秒 | **$0.095/秒** | $0.1406 | 32.4% |
-| 480p with video input | 11.5 /秒 | **$0.057/秒** | $0.0844 | 32.5% |
-| 720p no video input | 41 /秒 | **$0.205/秒** | $0.3024 | 32.2% |
-| 720p with video input | 25 /秒 | **$0.125/秒** | $0.1814 | 31.1% |
-| 1080p no video input | 102 /秒 | **$0.51/秒** | $0.6804 | 25.0% |
-| 1080p with video input | 62 /秒 | **$0.31/秒** | $0.4082 | 24.1% |
-| 4K no video input | 208 /秒 | **$1.04/秒** | $1.56 | 33.3% |
-| 4K with video input | 128 /秒 | **$0.64/秒** | $0.93 | 31.2% |
-
-> KIE 的计费说明：**无视频输入时 总价 = 单价 × 输出时长；有视频输入时 总价 = 单价 × (输入 + 输出) 时长**——这就是「with video」单价更低的原因。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
-- `generate_audio` 默认 `true`，会产生有声视频。
-- 参考图与首尾帧**共享 9 张的总额度**，UI 计数要把首帧/尾帧算进去。
-- `return_last_frame` 会改变 `resultJson` 的结构，解析逻辑必须分支处理。
-- `resolution` 档位是 480p / 720p / 1080p / 4k。
-- 有视频输入时计费口径变成「输入 + 输出总时长」，成本预估要区分。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Seedance 2.0 文档 | https://docs.kie.ai/cn/market/bytedance/seedance-2 | 否 |
-| 获取任务详情（含 return_last_frame 的结果结构） | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `seedance`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Seedance 2.0 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `bytedance/seedance-2` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "bytedance/seedance-2", callBackUrl?, input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`；**开启 `return_last_frame` 时结构为 `{ resultUrls: [], firstFrameUrl: [], lastFrameUrl: [] }`**（KIE 通用任务详情文档明确说明）
+
+## 2. 能力清单
+
+KIE 把 Seedance 2.0 系列做成**单端点多能力**：有无首帧/尾帧/参考图/参考视频/参考音频，都在同一个 `model` 下靠字段区分。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 见说明 | — | 文本提示词。schema 标为可选但描述写「必填字段」，长度 3–**20000** 字符 |
+| `input.first_frame_url` | string | 可选 | — | 首帧图片地址，或 `asset://{assetId}` |
+| `input.last_frame_url` | string | 可选 | — | 尾帧图片地址，或 `asset://{assetId}` |
+| `input.reference_image_urls` | array | 可选 | — | 参考图，**最多 9 张**（**与首尾帧张数之和不得超过 9 张**）。格式 jpeg/png/webp/bmp/tiff/gif；宽高比 (0.4, 2.5)；边长 (300, 6000) px；单张 < 30 MB |
+| `input.reference_video_urls` | array | 可选 | — | 参考视频，**最多 3 个**。格式 mp4/mov；分辨率 480p/720p；单个时长 [2, 15] s 且总时长 ≤ 15 s；宽高比 [0.4, 2.5]；边长 [300, 6000] px；总像素 [409600 (640×640), 927408 (834×1112)]；单个 ≤ 50 MB；帧率 [24, 60] |
+| `input.reference_audio_urls` | array | 可选 | — | 参考音频，**最多 3 段**。格式 wav/mp3；单个时长 [2, 15] s 且总时长 ≤ 15 s；单个 ≤ 15 MB |
+| `input.return_last_frame` | boolean | 可选 | `false` | 是否返回视频最后一帧图片 |
+| `input.generate_audio` | boolean | 可选 | **`true`** | 是否生成与画面同步的音频 |
+| `input.resolution` | string | 可选 | `720p` | `480p` / `720p` / `1080p` / `4k` |
+| `input.aspect_ratio` | string | 可选 | `16:9` | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`21:9`、`adaptive` |
+| `input.duration` | integer | 可选 | `5` | **4–15 秒** |
+| `input.web_search` | boolean | 可选 | — | 是否启用联网搜索 |
+| `input.nsfw_checker` | boolean | 可选 | `false` | `false` 时关闭内容过滤，结果直接返回 |
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)`：
+
+- 普通：`{ "resultUrls": ["https://....mp4"] }`
+- 开启 `return_last_frame`：`{ "resultUrls": [], "firstFrameUrl": [], "lastFrameUrl": [] }`
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `seedance`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 480p no video input | 19 /秒 | **$0.095/秒** | $0.1406 | 32.4% |
+| 480p with video input | 11.5 /秒 | **$0.057/秒** | $0.0844 | 32.5% |
+| 720p no video input | 41 /秒 | **$0.205/秒** | $0.3024 | 32.2% |
+| 720p with video input | 25 /秒 | **$0.125/秒** | $0.1814 | 31.1% |
+| 1080p no video input | 102 /秒 | **$0.51/秒** | $0.6804 | 25.0% |
+| 1080p with video input | 62 /秒 | **$0.31/秒** | $0.4082 | 24.1% |
+| 4K no video input | 208 /秒 | **$1.04/秒** | $1.56 | 33.3% |
+| 4K with video input | 128 /秒 | **$0.64/秒** | $0.93 | 31.2% |
+
+> KIE 的计费说明：**无视频输入时 总价 = 单价 × 输出时长；有视频输入时 总价 = 单价 × (输入 + 输出) 时长**——这就是「with video」单价更低的原因。
+
+## 6. 适配要点
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 边长 300–6000 px、宽高比 0.4–2.5；`videoConstraints` 边长 300–6000 px、总像素 409,600–927,408、宽高比 0.4–2.5。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
+- `generate_audio` 默认 `true`，会产生有声视频。
+- 参考图与首尾帧**共享 9 张的总额度**，UI 计数要把首帧/尾帧算进去。
+- `return_last_frame` 会改变 `resultJson` 的结构，解析逻辑必须分支处理。
+- `resolution` 档位是 480p / 720p / 1080p / 4k。
+- 有视频输入时计费口径变成「输入 + 输出总时长」，成本预估要区分。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Seedance 2.0 文档 | https://docs.kie.ai/cn/market/bytedance/seedance-2 | 否 |
+| 获取任务详情（含 return_last_frame 的结果结构） | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `seedance`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_/347/201/253/345/261/261/345/274/225/346/223/216.md

@@ -0,0 +1,101 @@
+# Seedance 2.0 · 火山引擎
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | 火山方舟（官方） |
+| 项目模型 ID | `volcengine-seedance-2.0`（通用标识 `seedance-2.0`） |
+| 平台模型 ID | `doubao-seedance-2-0-260128` |
+| 接口形态 | 异步任务（提交 + 轮询） |
+| 文档 / 价格可见性 | 公开，无需登录；开通 Seedance 2.x 需账户余额 > 200 元、200 元以上节省计划或资源包余量 |
+
+## 1. 接入协议
+
+- Base URL：`https://ark.cn-beijing.volces.com`；鉴权 `Authorization: Bearer <ARK_API_KEY>`
+- 提交：`POST /api/v3/contents/generations/tasks` → `{ "id": "cgt-..." }`（响应只有 `id`）
+- 查询：`GET /api/v3/contents/generations/tasks/{id}`；任务 ID 有效期 7 天，结果 URL 24 小时有效（Seedance 2.5 URL 最多下载 100 次），项目按统一媒体转存链路落盘
+- 取消：`DELETE /api/v3/contents/generations/tasks/{id}` 只能取消 `queued` 任务，`running` 不可取消。SDK 取消只停止本地轮询，不调用 DELETE
+
+## 2. 能力（按传入素材区分，三类互斥不可混用）
+
+| 场景 | content |
+|---|---|
+| 文生视频 | 仅 `text` |
+| 首帧 | 1 个 `image_url`，`role: first_frame`（或不填） |
+| 首尾帧 | 2 个 `image_url`，`role` 必填 `first_frame` / `last_frame`；尾帧比例不一致时以首帧为准裁剪 |
+| 全模态参考 | `image_url` + `role: reference_image`、`audio_url` + `role: reference_audio`、`video_url` + `role: reference_video`；参考图 1–9 张、参考音频最多 3 段（单段 2–15 秒，总 ≤ 15 秒）；音频不可单独传入，至少要有 1 个参考视频或参考图（官方原文“应至少包含 1 个参考视频或图片”） |
+
+图片支持公网 URL、`data:image/<格式>;base64,` 与 `asset://`；单张 < 30 MB，宽高比 0.4–2.5，边长 300–6000 px，请求体 ≤ 64 MB。音频支持公网 URL、`data:audio/<格式>;base64,`（格式 wav / mp3）与 `asset://`；单段 ≤ 15 MB。**参考视频只收公网 URL 或 `asset://`，不收 Base64**：最多 3 段，单段 2–15 秒，合计 ≤ 15 秒，mp4 / mov，单个 ≤ 200 MB，24–60 fps。本地视频经设置里的“通用文件上传服务”（KIE / Fal）托管成公网地址后提交，一家都没配置时提交前提示去设置；2.0 系列没有显式任务类型，带参考视频并在提示词写明意图即可编辑或延长。
+
+不支持直接上传含真人人脸的参考图 / 视频（需走官方授权素材或虚拟人像库）。
+
+## 3. 请求参数
+
+| 字段 | 取值 | 项目处理 |
+|---|---|---|
+| `model` | `doubao-seedance-2-0-260128` | 固定 |
+| `content` | 见第 2 节 | 提示词为空时不发 text 项；文生视频必须有提示词 |
+| `resolution` | `480p` / `720p` / `1080p` / `4k`（4k 为 10bit H.265）；默认 `720p` | 始终显式发送 |
+| `ratio` | `16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`；默认 `adaptive` | 「智能」发 `adaptive` |
+| `duration` | 4–15，或 `-1` 智能时长 | 4 起，默认 5 |
+| `generate_audio` | boolean，默认 true；输出固定双声道 | 开关 |
+| `return_last_frame` | boolean，默认 false；为 true 时结果多一个 `content.last_frame_url`（jpeg，无水印） | 开关；结果按「视频 ‖ 尾帧」顺序返回 |
+| `tools` | `[{ "type": "web_search" }]` | 「联网搜索」开关 |
+| `watermark` | boolean，默认 false | 固定 false |
+| `seed`、`camera_fixed`、`frames`、`service_tier` | 仅 Seedance 1.0 系列 | 不发送 |
+
+## 4. 价格
+
+来源：[模型价格](https://www.volcengine.com/docs/82379/1544106)（官方更新时间 2026-11-03，2026-11-07 读取，无需登录），在线推理，元 / 百万 token：
+
+| 输出分辨率 | 输入不含视频 | 输入含视频 |
+|---|---|---|
+| 480p / 720p | ¥46 | ¥28 |
+| 1080p | ¥51 | ¥31 |
+| 4k | ¥26 | ¥16 |
+
+- 视频价格 = token 单价 × token 用量；token ≈ (输入视频时长 + 输出时长) × 输出宽 × 输出高 × 24 / 1024，准确值以查询结果 `usage.completion_tokens` 为准；仅成功生成计费。
+- 典型价：480p 16:9 5 秒 ¥2.31；720p ¥4.97；1080p ¥12.39；4k ¥25.27（官方「价格示例」）。
+- 不带参考视频时按「输入不含视频」单价；带参考视频时按「输入含视频」单价，token 用量计入输入视频时长（读不到时长按输出时长估、封顶合计上限；2.5 编辑任务输出时长按输入时长估）。像素按官方表与所选比例，智能比例按 16:9。含视频时官方另有最低 token 用量（与分辨率、比例、输出时长有关，官方给的是飞书表格与计算器）：价格示例中输入 2–4 秒同价、与按输入 4 秒算出的 token 一致（如 2.0 480p 16:9 输出 5 秒：(4+5)×864×496×24/1024×¥28/百万 = ¥2.53），项目按“输入视频不足 4 秒按 4 秒计”估算。
+
+## 5. 事件 / 状态矩阵
+
+| 状态 | 前置 | 字段契约 | 空值语义 | 下一状态 | 对外输出 | 终态 / 错误 |
+|---|---|---|---|---|---|---|
+| 提交成功 | — | `id` string 必有 | 缺 `id` 判 `invalid_response` | queued | pending + taskId | 否 |
+| 提交失败 | — | HTTP 4xx/5xx，`error.code` / `error.message` | — | — | 无 | 是；余额、未开通、无权限按 `providerAccessErrors` 归类为不可重试 |
+| `queued` | 提交 | `status`；`content` 可缺 | 无结果 | running / cancelled / expired | 无 | 否，继续查询 |
+| `running` | queued | 同上 | 无结果 | succeeded / failed / expired | 无 | 否，继续查询 |
+| `succeeded` | running | `content.video_url` 必有；`content.last_frame_url` 仅 `return_last_frame` 时有；`usage.completion_tokens` | `video_url` 缺失判 `empty_result` | — | completed，URL 为视频（+ 尾帧） | 是 |
+| `failed` | queued / running | `error.code` / `error.message`（成功时 `error` 为 null） | `error` 缺失时用固定原因 | — | 无 | 是，`provider_task_failed`，不续查 |
+| `cancelled` | queued | — | — | — | 无 | 是；记录 24 小时后自动删除 |
+| `expired` | queued / running | `execution_expires_after`（默认 172800 秒） | 官方无 error 示例 | — | 无 | 是 |
+| 缺 `status` / 查询 HTTP 5xx / 网络错误 | 任意 | — | — | 保持 | 无 | 计入连续查询失败，连续 20 次后 `provider_task_unreachable` |
+
+不变量：只有 `succeeded` 且带 `video_url` 才算有效 final；用户取消时停止计时器与查询，不发 DELETE；官方未说明是否会乱序回退状态，SDK 不依赖状态顺序，只看当次状态。Seedance 2.5 部分任务类型要排到被消费时才返回报错（官方「报错机制」），因此失败可能在 `queued` 之后很久才出现。
+
+## 6. 项目适配
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 边长 300–6000 px、宽高比 0.4–2.5；文档未写参考视频尺寸，不校验视频。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 产品模型 `volcengine-seedance-2.0`，参数交互与 APIMart 同家族入口一致：`role: 'mode'` 模式（文/图生视频、参考生视频）+ 比例 + 分辨率 + 时长 + 声音 / 尾帧 / 联网搜索开关。
+- 比例「智能」发 `adaptive`（2.0 系列文生、首帧、参考均支持 `adaptive` 或指定比例）。
+- 4k 档 RPM 15、并发 1（模型列表），与其他分辨率不同。
+- 与 APIMart 同家族入口保持一致，不暴露智能时长。
+- 未接入：`priority`、`callback_url`、`execution_expires_after`、`safety_identifier`。
+- 本地图片、音频由方舟官方支持的 Data URI 发送；本地读出的 `audio/mpeg`、`audio/x-wav` 等 MIME 在发送前改成官方格式名 `mp3` / `wav`。
+- Fixture：`packages/ai-sdk/tests/fixtures/volcengine/video-*.json`；状态迁移与取消测试：`packages/ai-sdk/tests/providers/video-async-official.test.ts`；请求构建与价格：`packages/ai-sdk/tests/catalog/official-videos.test.ts`。未做真实付费调用。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 创建视频生成任务 API | https://www.volcengine.com/docs/82379/1520757 | 否 |
+| 查询视频生成任务 API | https://www.volcengine.com/docs/82379/1521309 | 否 |
+| 取消或删除视频生成任务 | https://www.volcengine.com/docs/82379/1521720 | 否 |
+| 模型列表（模型 ID、分辨率、时长、限流） | https://www.volcengine.com/docs/82379/1330310 | 否 |
+| 模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
+| 错误码 | https://www.volcengine.com/docs/82379/1299023 | 否 |
+| Seedance 2.5 教程 / 2.0 系列教程 | https://www.volcengine.com/docs/82379/2607688 ; https://www.volcengine.com/docs/82379/2291680 | 否 |
+
+> 机器可读原文：`https://docs.volcengine.com/api/doc/getDocDetail?LibraryID=82379&DocumentID=<id>&type=online`。

package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_APIMart.md

@@ -1,89 +1,89 @@
-# Seedance 2.0 Fast · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 视频 |
-| 供应商 | APIMart（聚合平台） |
-| 平台模型 ID | `seedance-2.0-fast` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> APIMart 把 `seedance-2.0` / `seedance-2.0-fast` / `seedance-2.0-mini` 写在**同一份文档**里，参数结构完全一致，差异在**分辨率上限**与**提示词长度**。
-
-## 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}`，状态 `pending` / `processing` / `completed` / `failed`，结果在 `result.videos[]`
-
-## 2. 能力清单
-
-文生视频、图生视频（首帧）、首尾帧视频、参考视频生视频、参考音频、有声视频、连续视频生成（返回尾帧）、联网搜索增强、私域虚拟人像素材（Asset URL）。**功能与标准版一致**。
-
-## 3. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必填 | — | `seedance-2.0-fast` |
-| `prompt` | string | 条件 | — | **文生视频必填**；图生视频 / 视频参考生视频可选。限制 4000 字符，建议 500 字符以内 |
-| `duration` | integer | 可选 | `5` | **4 ~ 15 秒** |
-| `size` | string | 可选 | `16:9` | `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9`、`adaptive`。宽高比须在 0.5–2.5 之间 |
-| `resolution` | string | 可选 | `720p` | **仅 `480p` / `720p`**（`1080p` 与 `4k` 只有标准版 `seedance-2.0` 支持） |
-| `seed` | integer | 可选 | — | 随机种子。**本项目规则：绝对不显示**，不下发 |
-| `generate_audio` | boolean | 可选 | **`true`** | 是否生成配套音频 |
-| `return_last_frame` | boolean | 可选 | `false` | `true` 时额外返回尾帧图片 URL，用于连续视频生成 |
-| `tools` | array | 可选 | — | 如 `[{"type": "web_search"}]`（联网搜索） |
-| `image_urls` | string[] | 可选 | — | 图生视频参考图。普通 URL 或 `asset://asset_a`。**最多 9 张**。**与 `image_with_roles` 不能同时使用** |
-| `image_with_roles` | array | 可选 | — | `{ url, role }`，`role` ∈ `first_frame` / `last_frame` / `reference_image`。**与 `image_urls` 不能同时使用** |
-| `video_urls` | string[] | 可选 | — | 参考视频。**最多 3 个，1.8 s < 总时长 < 15.2 s，分辨率 480P ~ 720P**。**使用首/尾帧图片时不可用** |
-| `audio_urls` | string[] | 可选 | — | 参考音频。**最多 3 个，总时长 ≤ 15 s**。**必须与参考图片或参考视频一起用**；**使用首/尾帧图片时不可用** |
-| `nsfw_check` | boolean | 可选 | `false` | 命中时同步返回 HTTP 400（`nsfw_content_detected`），不建任务不扣费；审核不可用时 **fail-open**；`video_urls` / `audio_urls` **不送审** |
-
-### 互斥与依赖关系（务必在 UI 层做约束）
-
-- `image_urls` ⊗ `image_with_roles`（二选一）
-- 使用 `image_with_roles` 的首/尾帧时，`video_urls` 与 `audio_urls` **都不可用**
-- `audio_urls` 必须与参考图片或参考视频一起使用
-
-## 4. 私域虚拟人像素材（Asset URL）
-
-独立端点 `POST https://api.apimart.ai/v1/seedance2/private-avatar`，**支持全部 Seedance 2.0 模型**（含本模型）。字段与流程见 [Seedance-2.0_APIMart.md](../Seedance-2.0/Seedance-2.0_APIMart.md#4-私域虚拟人像素材asset-url)：素材组 `group` / `group_id`、`project_name`、`asset_type`（Image/Video/Audio）、`assets`（单次最多 20 个）；审核结果用 `GET /v1/tasks/{id}` 查询，通过的素材出现在 `result.usable_assets`，其 `asset_url` 可直接以 `asset://` 形式传入生成接口。
-
-## 5. 价格
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) → 视频标签页（2026-08-30 复核，1 Credit ≈ $0.1）。当前定价中心与模型页的秒价口径一致，未发现新的价格冲突。
-
-`SEEDANCE-2.0-FAST`（4 个档位）
-
-| 规格 | 我们的价格 |
-|---|---|
-| 480P | 0.3984 Credits/秒 ≈ **$0.03984/秒** |
-| 480P-input | 0.2368 Credits/秒 ≈ **$0.02368/秒** |
-| 720P | 0.856 Credits/秒 ≈ **$0.0856/秒** |
-| 720P-input | 0.5128 Credits/秒 ≈ **$0.05128/秒** |
-
-`-input` 档位对应「有参考视频输入」的计费方式（单价更低，但按输入 + 输出总时长计费）。
-
-**数字人（私域人像）另有独立价格** `SEEDANCE-2.0-FAST-FACE`：480P 0.8 Credits/秒 ≈ $0.08/秒、480P-input 0.48 ≈ $0.048/秒、720P 1.72 ≈ $0.172/秒、720P-input 1.032 ≈ $0.1032/秒。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口**有 `seed`**（不下发）。
-- **参数互斥关系是这个模型最容易踩的坑**，UI 必须做互斥禁用。
-- `generate_audio` **默认 `true`**。
-- **`1080p` / `4k` 在本模型上不可用**，只有标准版 `seedance-2.0` 支持。
-- 有参考视频时计费按「输入 + 输出总时长」。
-- SDK 从 `uploadedVideoFilePaths` / `videos` / `uploadedVideos` 取非空且数量最完整的一组；空数组不遮蔽其他字段。宿主按顺序提供完整 `__videoDurationSeconds: number[]` 时求真实总和，数组不完整时改用 `__totalVideoDurationSeconds`，最后才兼容 `__firstVideoDurationSeconds × 视频数` 的旧近似估算。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| seedance-2.0 视频生成（三个版本共用文档） | https://docs.apimart.ai/cn/api-reference/videos/seedance-2-0/generation | 否 |
-| 虚拟人像素材（私域 Asset） | https://docs.apimart.ai/cn/api-reference/videos/seedance-2-0/private-avatar | 否 |
-| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
-| 定价中心（视频标签页） | https://apimart.ai/zh/pricing | 否 |
-| API Key 管理 | https://apimart.ai/keys | **是** |
+# Seedance 2.0 Fast · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `seedance-2.0-fast` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> APIMart 把 `seedance-2.0` / `seedance-2.0-fast` / `seedance-2.0-mini` 写在**同一份文档**里，参数结构完全一致，差异在**分辨率上限**与**提示词长度**。
+
+## 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}`，状态 `pending` / `processing` / `completed` / `failed`，结果在 `result.videos[]`
+
+## 2. 能力清单
+
+文生视频、图生视频（首帧）、首尾帧视频、参考视频生视频、参考音频、有声视频、连续视频生成（返回尾帧）、联网搜索增强、私域虚拟人像素材（Asset URL）。**功能与标准版一致**。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | — | `seedance-2.0-fast` |
+| `prompt` | string | 条件 | — | **文生视频必填**；图生视频 / 视频参考生视频可选。限制 4000 字符，建议 500 字符以内 |
+| `duration` | integer | 可选 | `5` | **4 ~ 15 秒** |
+| `size` | string | 可选 | `16:9` | `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9`、`adaptive`。宽高比须在 0.5–2.5 之间 |
+| `resolution` | string | 可选 | `720p` | **仅 `480p` / `720p`**（`1080p` 与 `4k` 只有标准版 `seedance-2.0` 支持） |
+| `seed` | integer | 可选 | — | 随机种子。**本项目规则：绝对不显示**，不下发 |
+| `generate_audio` | boolean | 可选 | **`true`** | 是否生成配套音频 |
+| `return_last_frame` | boolean | 可选 | `false` | `true` 时额外返回尾帧图片 URL，用于连续视频生成 |
+| `tools` | array | 可选 | — | 如 `[{"type": "web_search"}]`（联网搜索） |
+| `image_urls` | string[] | 可选 | — | 图生视频参考图。普通 URL 或 `asset://asset_a`。**最多 9 张**。**与 `image_with_roles` 不能同时使用** |
+| `image_with_roles` | array | 可选 | — | `{ url, role }`，`role` ∈ `first_frame` / `last_frame` / `reference_image`。**与 `image_urls` 不能同时使用** |
+| `video_urls` | string[] | 可选 | — | 参考视频。**最多 3 个，1.8 s < 总时长 < 15.2 s，分辨率 480P ~ 720P**。**使用首/尾帧图片时不可用** |
+| `audio_urls` | string[] | 可选 | — | 参考音频。**最多 3 个，总时长 ≤ 15 s**。**必须与参考图片或参考视频一起用**；**使用首/尾帧图片时不可用** |
+| `nsfw_check` | boolean | 可选 | `false` | 命中时同步返回 HTTP 400（`nsfw_content_detected`），不建任务不扣费；审核不可用时 **fail-open**；`video_urls` / `audio_urls` **不送审** |
+
+### 互斥与依赖关系（务必在 UI 层做约束）
+
+- `image_urls` ⊗ `image_with_roles`（二选一）
+- 使用 `image_with_roles` 的首/尾帧时，`video_urls` 与 `audio_urls` **都不可用**
+- `audio_urls` 必须与参考图片或参考视频一起使用
+
+## 4. 私域虚拟人像素材（Asset URL）
+
+独立端点 `POST https://api.apimart.ai/v1/seedance2/private-avatar`，**支持全部 Seedance 2.0 模型**（含本模型）。字段与流程见 [Seedance-2.0_APIMart.md](../Seedance-2.0/Seedance-2.0_APIMart.md#4-私域虚拟人像素材asset-url)：素材组 `group` / `group_id`、`project_name`、`asset_type`（Image/Video/Audio）、`assets`（单次最多 20 个）；审核结果用 `GET /v1/tasks/{id}` 查询，通过的素材出现在 `result.usable_assets`，其 `asset_url` 可直接以 `asset://` 形式传入生成接口。
+
+## 5. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) → 视频标签页（2026-08-30 复核，1 Credit ≈ $0.1）。当前定价中心与模型页的秒价口径一致，未发现新的价格冲突。
+
+`SEEDANCE-2.0-FAST`（4 个档位）
+
+| 规格 | 我们的价格 |
+|---|---|
+| 480P | 0.3984 Credits/秒 ≈ **$0.03984/秒** |
+| 480P-input | 0.2368 Credits/秒 ≈ **$0.02368/秒** |
+| 720P | 0.856 Credits/秒 ≈ **$0.0856/秒** |
+| 720P-input | 0.5128 Credits/秒 ≈ **$0.05128/秒** |
+
+`-input` 档位对应「有参考视频输入」的计费方式（单价更低，但按输入 + 输出总时长计费）。
+
+**数字人（私域人像）另有独立价格** `SEEDANCE-2.0-FAST-FACE`：480P 0.8 Credits/秒 ≈ $0.08/秒、480P-input 0.48 ≈ $0.048/秒、720P 1.72 ≈ $0.172/秒、720P-input 1.032 ≈ $0.1032/秒。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口**有 `seed`**（不下发）。
+- **参数互斥关系是这个模型最容易踩的坑**，UI 必须做互斥禁用。
+- `generate_audio` **默认 `true`**。
+- **`1080p` / `4k` 在本模型上不可用**，只有标准版 `seedance-2.0` 支持。
+- 有参考视频时计费按「输入 + 输出总时长」。
+- SDK 从 `uploadedVideoFilePaths` / `videos` / `uploadedVideos` 取非空且数量最完整的一组；空数组不遮蔽其他字段。宿主按顺序提供完整 `__videoDurationSeconds: number[]` 时求真实总和，数组不完整时改用 `__totalVideoDurationSeconds`，最后才兼容 `__firstVideoDurationSeconds × 视频数` 的旧近似估算。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| seedance-2.0 视频生成（三个版本共用文档） | https://docs.apimart.ai/cn/api-reference/videos/seedance-2-0/generation | 否 |
+| 虚拟人像素材（私域 Asset） | https://docs.apimart.ai/cn/api-reference/videos/seedance-2-0/private-avatar | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（视频标签页） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |