@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation/SeedASR-2.0-Realtime/SeedASR-2.0-Realtime_/347/201/253/345/261/261/345/274/225/346/223/216.md

@@ -1,147 +1,147 @@
-# SeedASR 2.0 Realtime · 火山引擎
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-24 |
-| 能力 | 双向实时语音识别（二进制 WebSocket） |
-| SDK `modelId` | `seedasr-2.0-realtime` |
-| 火山请求模型 | `request.model_name="bigmodel"` + 2.0 资源 ID `volc.seedasr.sauc.duration` |
-| P0 音频 | PCM S16LE、16 kHz、16 bit、单声道 |
-| 文档/价格 | 公开；API Key、开通和用量需登录 |
-
-## 1. 端点与新版鉴权
-
-P0 使用官方双向流式优化端点：
-
-```text
-wss://openspeech.bytedance.com/api/v3/sauc/bigmodel_async
-```
-
-握手头：
-
-```text
-X-Api-Key: <API Key>
-X-Api-Resource-Id: volc.seedasr.sauc.duration
-X-Api-Request-Id: <客户端生成的 UUID>
-X-Api-Sequence: -1
-```
-
-只支持新版 `X-Api-Key`。同一官方页面同时列出 1.0 的 `volc.bigasr.sauc.*` 与 2.0 的 `volc.seedasr.sauc.*`；本模型固定 2.0 小时版资源 ID。并发版 `volc.seedasr.sauc.concurrent` 属于另一计费形态，不在 P0 中静默切换。
-
-## 2. 首帧与音频规格
-
-首帧 JSON 经 UTF-8 + gzip 后装入二进制帧：
-
-```json
-{
-  "user": { "uid": "<request UUID>" },
-  "audio": {
-    "format": "pcm",
-    "codec": "raw",
-    "rate": 16000,
-    "bits": 16,
-    "channel": 1
-  },
-  "request": {
-    "model_name": "bigmodel",
-    "enable_itn": true,
-    "enable_punc": true,
-    "enable_ddc": false,
-    "show_utterances": true,
-    "enable_nonstream": false,
-    "result_type": "full"
-  }
-}
-```
-
-P0 不在 SDK 内转码：输入不符合 PCM S16LE/16 kHz/mono 时，在建立付费连接前失败。每个 PCM16 音频块的字节数必须为偶数。官方示例建议每 200 ms 一包，即 6400 字节；分块节奏由宿主负责。
-
-`bigmodel_async` 当前契约不发送 `audio.language`；传入 `language` 或热词 `hints` 会明确报不支持，避免静默丢参数。
-
-## 3. 二进制帧契约
-
-### 3.1 4 字节头
-
-| 位置 | 高 4 bit | 低 4 bit |
-|---|---|---|
-| byte 0 | version=`1` | header size=`1`（4 字节） |
-| byte 1 | message type | flags |
-| byte 2 | serialization | compression |
-| byte 3 | reserved | reserved |
-
-消息与标志：
-
-| 值 | 含义 |
-|---|---|
-| message type `1` | client full request |
-| message type `2` | client audio-only request |
-| message type `9` | server full response |
-| message type `15` | server error response |
-| flag bit `1` | 帧含 4 字节大端有符号 sequence |
-| flag bit `2` | 最后一包 |
-| flag bit `4` | 帧含 4 字节大端 event |
-| serialization `0/1` | none / JSON |
-| compression `0/1` | none / gzip |
-
-完整响应布局为 `header → [sequence] → [event] → uint32 payload_size → payload`；错误响应为 `header → [sequence] → [event] → uint32 error_code → uint32 payload_size → payload`。解析器要求声明长度与实际剩余字节完全一致，断牙和尾随字节都报 `invalid_response`。服务端 payload 同时接受 `compression=none/gzip`，其他压缩或序列化值拒绝。
-
-### 3.2 当前官方附件的客户端帧
-
-| 帧 | 头 hex | sequence | payload |
-|---|---|---|---|
-| 首帧 | `11 11 11 00` | `1` | JSON UTF-8 + gzip |
-| 普通音频 | `11 21 11 00` | 正数，从 `2` 递增 | 原始 PCM + gzip |
-| 最后一块真实音频 | `11 23 11 00` | 当前序号取负数 | 原始 PCM + gzip |
-
-协议字段表把原始音频描述为 `serialization=none`，但 2026-08-08 当前官方 Python 附件对音频帧实际写入 `serialization=JSON` 标志（第三字节 `0x11`），附件自带成功 `run.log` 也使用这一结构。P0 以可复现的当前官方附件为准锁定 `0x11`；这是已记录的官方资料内部差异，后续若官方修正文档或附件需重新验证，而不是同时猜两套发送协议。
-
-SDK 对音频保留一块延迟：收到下一块时才把上一块以正 sequence 发出；`finish()` 把最后一块真实音频以负 sequence 发送。不会制造空终止音频包。无任何真实音频就 `finish()` 会报 `invalid_audio`。
-
-## 4. 服务端事件矩阵
-
-| 服务端帧/字段 | Capability 事件 | 终态 | 行为 |
-|---|---|---|---|
-| 首个合法 type `9` full response | `started` | 否 | 官方附件该帧 `result.text=""`；SDK 不要求必须为空，也不产生空 partial |
-| type `9`，非空 `result.text` | `partial` | 否 | 文本变化才发，重复内容去重 |
-| `result.utterances[].definite=true` | `final` | 否 | 表示句段已确定，不等于整个连接结束；按时间范围/文本去重 |
-| flag bit `2`（last） | `completed` | 是 | 只有客户端已 `finish()` 后才合法；输出 `result.text/utterances/audio_info.duration` |
-| type `15` | 无 | 是（错误） | 读取 uint32 错误码；错误 payload 可为 JSON 或 UTF-8 文本，默认异常/日志只保留错误码，不带原始 message |
-| 未知 `event` 数字 | 无 | 否 | 只记脱敏 warning，仍按 type/payload 处理 |
-| WebSocket 提前断开 | 无 | 是（错误） | `provider_connection_closed`，不误报完成 |
-| text WebSocket frame | 无 | 是（错误） | 协议要求二进制，报 `invalid_response` |
-
-`utterances[].definite=true` 只能判断句段 final，整个会话终态必须看帧头 last 标志。整个终帧仍无有效文本时严格报 `invalid_response`。
-
-用户主动取消只关闭连接，不发送负 sequence 终帧，也不把取消伪装成正常完成。full request 默认在 15 秒内必须收到首个服务端响应，可用 `openTimeoutMs` 显式调整；超时会关闭半开连接。`finish()`、连接释放和显式 `close()` 都幂等；发送失败、服务端错误、断线、超时和取消都走同一个释放边界。
-
-同一响应帧可能同时产生 partial 与一个或多个 final。每次事件回调后重新检查取消/关闭，避免调用方在 partial 回调取消后，SDK 仍继续发出该帧的 final；该场景使用官方响应 payload 调整 last 标志构造，不代表新的供应商事件类型。
-
-2026-09-24 诊断复核：异常 details 保留实际 `modelId=seedasr-2.0-realtime`、`protocol=volcengine-binary-v1`、会话阶段、操作与最后一帧的序号/event/last 标志。原始服务端 message 和宿主异常可能包含识别内容或凭据，不进入默认诊断。握手失败后若关闭也失败，继续报告首个故障，并附 `cleanupFailed=true`。`volcengine-realtime-asr.test.ts` 使用既有官方帧结构、受控敏感文本错误与 Mock close 拒绝验证这些边界；不是额外真实服务实录。
-
-## 5. 价格与免费额度
-
-| 项目 | 官方公开值 |
-|---|---|
-| 后付费（小时版） | 1 元/小时 |
-| 免费试用 | 20 小时 |
-| 有效期 | 开通后 6 个月 |
-
-20 小时为需在豆包语音控制台开通的试用额度，不是每月自动刷新。并发版的资源与计费方式不同，不应把本页小时版单价套到并发版。
-
-## 6. Fixture 与验证来源
-
-| Fixture | 分类 | 用途 |
-|---|---|---|
-| `asr-seedasr-official.json` | `official-redacted` | 官方附件成功 `run.log` 的握手/空进度/终帧；仅 `log_id` 脱敏 |
-| `asr-seedasr-field-construction.json` | `field-construction` | 按官方当前附件构造三类客户端帧与首帧字段 |
-| `asr-seedasr-synthetic.json` | `synthetic-negative` | 未知 event、错误码、断牙/尾随字节等负例 |
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| 流式 API/二进制协议 | https://docs.volcengine.com/docs/6561/1354869?lang=zh | 否 |
-| 双向流式优化端点与当前附件 | https://docs.volcengine.com/docs/6561/2630027?lang=zh | 否 |
-| 流式调用示例/资源 ID | https://docs.volcengine.com/docs/6561/2628951?lang=zh | 否 |
-| 计费与免费试用 | https://docs.volcengine.com/docs/6561/1359369?lang=zh | 否 |
-| 豆包语音控制台 | https://console.volcengine.com/speech/new/overview | **是** |
+# SeedASR 2.0 Realtime · 火山引擎
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-24 |
+| 能力 | 双向实时语音识别（二进制 WebSocket） |
+| SDK `modelId` | `seedasr-2.0-realtime` |
+| 火山请求模型 | `request.model_name="bigmodel"` + 2.0 资源 ID `volc.seedasr.sauc.duration` |
+| P0 音频 | PCM S16LE、16 kHz、16 bit、单声道 |
+| 文档/价格 | 公开；API Key、开通和用量需登录 |
+
+## 1. 端点与新版鉴权
+
+P0 使用官方双向流式优化端点：
+
+```text
+wss://openspeech.bytedance.com/api/v3/sauc/bigmodel_async
+```
+
+握手头：
+
+```text
+X-Api-Key: <API Key>
+X-Api-Resource-Id: volc.seedasr.sauc.duration
+X-Api-Request-Id: <客户端生成的 UUID>
+X-Api-Sequence: -1
+```
+
+只支持新版 `X-Api-Key`。同一官方页面同时列出 1.0 的 `volc.bigasr.sauc.*` 与 2.0 的 `volc.seedasr.sauc.*`；本模型固定 2.0 小时版资源 ID。并发版 `volc.seedasr.sauc.concurrent` 属于另一计费形态，不在 P0 中静默切换。
+
+## 2. 首帧与音频规格
+
+首帧 JSON 经 UTF-8 + gzip 后装入二进制帧：
+
+```json
+{
+  "user": { "uid": "<request UUID>" },
+  "audio": {
+    "format": "pcm",
+    "codec": "raw",
+    "rate": 16000,
+    "bits": 16,
+    "channel": 1
+  },
+  "request": {
+    "model_name": "bigmodel",
+    "enable_itn": true,
+    "enable_punc": true,
+    "enable_ddc": false,
+    "show_utterances": true,
+    "enable_nonstream": false,
+    "result_type": "full"
+  }
+}
+```
+
+P0 不在 SDK 内转码：输入不符合 PCM S16LE/16 kHz/mono 时，在建立付费连接前失败。每个 PCM16 音频块的字节数必须为偶数。官方示例建议每 200 ms 一包，即 6400 字节；分块节奏由宿主负责。
+
+`bigmodel_async` 当前契约不发送 `audio.language`；传入 `language` 或热词 `hints` 会明确报不支持，避免静默丢参数。
+
+## 3. 二进制帧契约
+
+### 3.1 4 字节头
+
+| 位置 | 高 4 bit | 低 4 bit |
+|---|---|---|
+| byte 0 | version=`1` | header size=`1`（4 字节） |
+| byte 1 | message type | flags |
+| byte 2 | serialization | compression |
+| byte 3 | reserved | reserved |
+
+消息与标志：
+
+| 值 | 含义 |
+|---|---|
+| message type `1` | client full request |
+| message type `2` | client audio-only request |
+| message type `9` | server full response |
+| message type `15` | server error response |
+| flag bit `1` | 帧含 4 字节大端有符号 sequence |
+| flag bit `2` | 最后一包 |
+| flag bit `4` | 帧含 4 字节大端 event |
+| serialization `0/1` | none / JSON |
+| compression `0/1` | none / gzip |
+
+完整响应布局为 `header → [sequence] → [event] → uint32 payload_size → payload`；错误响应为 `header → [sequence] → [event] → uint32 error_code → uint32 payload_size → payload`。解析器要求声明长度与实际剩余字节完全一致，断牙和尾随字节都报 `invalid_response`。服务端 payload 同时接受 `compression=none/gzip`，其他压缩或序列化值拒绝。
+
+### 3.2 当前官方附件的客户端帧
+
+| 帧 | 头 hex | sequence | payload |
+|---|---|---|---|
+| 首帧 | `11 11 11 00` | `1` | JSON UTF-8 + gzip |
+| 普通音频 | `11 21 11 00` | 正数，从 `2` 递增 | 原始 PCM + gzip |
+| 最后一块真实音频 | `11 23 11 00` | 当前序号取负数 | 原始 PCM + gzip |
+
+协议字段表把原始音频描述为 `serialization=none`，但 2026-08-08 当前官方 Python 附件对音频帧实际写入 `serialization=JSON` 标志（第三字节 `0x11`），附件自带成功 `run.log` 也使用这一结构。P0 以可复现的当前官方附件为准锁定 `0x11`；这是已记录的官方资料内部差异，后续若官方修正文档或附件需重新验证，而不是同时猜两套发送协议。
+
+SDK 对音频保留一块延迟：收到下一块时才把上一块以正 sequence 发出；`finish()` 把最后一块真实音频以负 sequence 发送。不会制造空终止音频包。无任何真实音频就 `finish()` 会报 `invalid_audio`。
+
+## 4. 服务端事件矩阵
+
+| 服务端帧/字段 | Capability 事件 | 终态 | 行为 |
+|---|---|---|---|
+| 首个合法 type `9` full response | `started` | 否 | 官方附件该帧 `result.text=""`；SDK 不要求必须为空，也不产生空 partial |
+| type `9`，非空 `result.text` | `partial` | 否 | 文本变化才发，重复内容去重 |
+| `result.utterances[].definite=true` | `final` | 否 | 表示句段已确定，不等于整个连接结束；按时间范围/文本去重 |
+| flag bit `2`（last） | `completed` | 是 | 只有客户端已 `finish()` 后才合法；输出 `result.text/utterances/audio_info.duration` |
+| type `15` | 无 | 是（错误） | 读取 uint32 错误码；错误 payload 可为 JSON 或 UTF-8 文本，默认异常/日志只保留错误码，不带原始 message |
+| 未知 `event` 数字 | 无 | 否 | 只记脱敏 warning，仍按 type/payload 处理 |
+| WebSocket 提前断开 | 无 | 是（错误） | `provider_connection_closed`，不误报完成 |
+| text WebSocket frame | 无 | 是（错误） | 协议要求二进制，报 `invalid_response` |
+
+`utterances[].definite=true` 只能判断句段 final，整个会话终态必须看帧头 last 标志。整个终帧仍无有效文本时严格报 `invalid_response`。
+
+用户主动取消只关闭连接，不发送负 sequence 终帧，也不把取消伪装成正常完成。full request 默认在 15 秒内必须收到首个服务端响应，可用 `openTimeoutMs` 显式调整；超时会关闭半开连接。`finish()`、连接释放和显式 `close()` 都幂等；发送失败、服务端错误、断线、超时和取消都走同一个释放边界。
+
+同一响应帧可能同时产生 partial 与一个或多个 final。每次事件回调后重新检查取消/关闭，避免调用方在 partial 回调取消后，SDK 仍继续发出该帧的 final；该场景使用官方响应 payload 调整 last 标志构造，不代表新的供应商事件类型。
+
+2026-09-24 诊断复核：异常 details 保留实际 `modelId=seedasr-2.0-realtime`、`protocol=volcengine-binary-v1`、会话阶段、操作与最后一帧的序号/event/last 标志。原始服务端 message 和宿主异常可能包含识别内容或凭据，不进入默认诊断。握手失败后若关闭也失败，继续报告首个故障，并附 `cleanupFailed=true`。`volcengine-realtime-asr.test.ts` 使用既有官方帧结构、受控敏感文本错误与 Mock close 拒绝验证这些边界；不是额外真实服务实录。
+
+## 5. 价格与免费额度
+
+| 项目 | 官方公开值 |
+|---|---|
+| 后付费（小时版） | 1 元/小时 |
+| 免费试用 | 20 小时 |
+| 有效期 | 开通后 6 个月 |
+
+20 小时为需在豆包语音控制台开通的试用额度，不是每月自动刷新。并发版的资源与计费方式不同，不应把本页小时版单价套到并发版。
+
+## 6. Fixture 与验证来源
+
+| Fixture | 分类 | 用途 |
+|---|---|---|
+| `asr-seedasr-official.json` | `official-redacted` | 官方附件成功 `run.log` 的握手/空进度/终帧；仅 `log_id` 脱敏 |
+| `asr-seedasr-field-construction.json` | `field-construction` | 按官方当前附件构造三类客户端帧与首帧字段 |
+| `asr-seedasr-synthetic.json` | `synthetic-negative` | 未知 event、错误码、断牙/尾随字节等负例 |
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| 流式 API/二进制协议 | https://docs.volcengine.com/docs/6561/1354869?lang=zh | 否 |
+| 双向流式优化端点与当前附件 | https://docs.volcengine.com/docs/6561/2630027?lang=zh | 否 |
+| 流式调用示例/资源 ID | https://docs.volcengine.com/docs/6561/2628951?lang=zh | 否 |
+| 计费与免费试用 | https://docs.volcengine.com/docs/6561/1359369?lang=zh | 否 |
+| 豆包语音控制台 | https://console.volcengine.com/speech/new/overview | **是** |

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

@@ -1,45 +1,45 @@
-# SeedVR2 图片放大（Fal）
-
-## 契约
-
-| 项目 | 内容 |
-|---|---|
-| endpoint ID | `fal-ai/seedvr/upscale/image` |
-| 输入 | `image_url`，应用严格要求 1 张图片 |
-| 官方模式 | `factor` 或 `target`；应用只开放 factor 模式 |
-| 应用参数 | 2×/4×、`noise_scale` 0～1（默认 0.1） |
-| 隐藏字段 | `seed`、`output_format`、`sync_mode`、target resolution |
-| 输出 | `image: File` |
-| 价格 | Fal 标价 `$0.001/MP` |
-| 资料核查 | 2026-08-29；公开，无需登录 |
-
-官方价格只标明 megapixels billing unit，没有在公开页明确它指输入还是输出。应用采用“预计输出 MP ×
-$0.001”的保守展示口径，并在价格文案中明确这是估价；SDK 通过 `pricing.mediaContext` 声明源图像素与
-2×/4× 面积倍率，宿主共享价格层统一读取媒体指标。指标未解析成功时不显示伪造兜底价；实际账单仍以
-Fal billing event 为准。
-
-## 请求示例
-
-```json
-{
-  "image_url": "https://example.com/source.jpg",
-  "upscale_mode": "factor",
-  "upscale_factor": 4,
-  "noise_scale": 0.1
-}
-```
-
-## 队列与适配
-
-使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`，状态为 `IN_QUEUE`、
-`IN_PROGRESS`、`COMPLETED`。canonical ID 为 `seedvr2-image-upscale`，应用模型 ID 为
-`fal-ai-seedvr2-image-upscale`。默认 JPG 输出不保证 alpha，因此画布预检会提示透明图改用专用模型。
-已完成端点、字段钳制、单图限制、2×/4×预检和输出 MP 估价的离线测试；未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API 文档 | https://fal.ai/models/fal-ai/seedvr/upscale/image/api | 否 |
-| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/seedvr/upscale/image | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# SeedVR2 图片放大（Fal）
+
+## 契约
+
+| 项目 | 内容 |
+|---|---|
+| endpoint ID | `fal-ai/seedvr/upscale/image` |
+| 输入 | `image_url`，应用严格要求 1 张图片 |
+| 官方模式 | `factor` 或 `target`；应用只开放 factor 模式 |
+| 应用参数 | 2×/4×、`noise_scale` 0～1（默认 0.1） |
+| 隐藏字段 | `seed`、`output_format`、`sync_mode`、target resolution |
+| 输出 | `image: File` |
+| 价格 | Fal 标价 `$0.001/MP` |
+| 资料核查 | 2026-08-29；公开，无需登录 |
+
+官方价格只标明 megapixels billing unit，没有在公开页明确它指输入还是输出。应用采用“预计输出 MP ×
+$0.001”的保守展示口径，并在价格文案中明确这是估价；SDK 通过 `pricing.mediaContext` 声明源图像素与
+2×/4× 面积倍率，宿主共享价格层统一读取媒体指标。指标未解析成功时不显示伪造兜底价；实际账单仍以
+Fal billing event 为准。
+
+## 请求示例
+
+```json
+{
+  "image_url": "https://example.com/source.jpg",
+  "upscale_mode": "factor",
+  "upscale_factor": 4,
+  "noise_scale": 0.1
+}
+```
+
+## 队列与适配
+
+使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`，状态为 `IN_QUEUE`、
+`IN_PROGRESS`、`COMPLETED`。canonical ID 为 `seedvr2-image-upscale`，应用模型 ID 为
+`fal-ai-seedvr2-image-upscale`。默认 JPG 输出不保证 alpha，因此画布预检会提示透明图改用专用模型。
+已完成端点、字段钳制、单图限制、2×/4×预检和输出 MP 估价的离线测试；未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API 文档 | https://fal.ai/models/fal-ai/seedvr/upscale/image/api | 否 |
+| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/seedvr/upscale/image | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |

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

@@ -1,121 +1,121 @@
-# Seedance 2.0 · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 视频 |
-| 供应商 | APIMart（聚合平台） |
-| 平台模型 ID | `seedance-2.0`（旧名 `seedance-2-0`） |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> 同一份 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` |
-| `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`（仅标准版）** |
-| `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`（参考人像图，配合 Asset URL）。**与 `image_urls` 不能同时使用** |
-| `video_urls` | string[] | 可选 | — | 参考视频。**最多 3 个，1.8 s < 总时长 < 15.2 s，分辨率需在 480P ~ 720P 之间**。**使用首/尾帧图片时不可用** |
-| `audio_urls` | string[] | 可选 | — | 参考音频。**最多 3 个，总时长 ≤ 15 s**。**必须与参考图片或参考视频一起用**；**使用首/尾帧图片时不可用** |
-| `nsfw_check` | boolean | 可选 | `false` | 见下 |
-
-### 互斥与依赖关系（务必在 UI 层做约束）
-
-- `image_urls` ⊗ `image_with_roles`（二选一）
-- 使用 `image_with_roles` 的首/尾帧时，`video_urls` 与 `audio_urls` **都不可用**
-- `audio_urls` 必须与参考图片或参考视频一起使用
-
-### `nsfw_check` 细节
-
-- 审核范围：文本 `prompt`、`negative_prompt`；图片 `image_urls`、`image_with_roles[].url`、`first_frame_image`、`last_frame_image`；`asset://` 图片素材会反查原始公网 URL 后审核；base64 图片转公网地址后审核
-- **`video_urls`、`audio_urls` 以及视频/音频类型的私域素材不会送审**（审核模型不支持视频和音频）
-- 命中审核时**同步返回 HTTP 400（`nsfw_content_detected`）**，不创建任务、不返回 `task_id`、不扣额度
-- 审核服务不可用/超时/响应异常时采用 **fail-open**（继续提交生成请求），因此**不能作为绝对的内容安全保证**
-- 审核调用本身不向发起视频请求的用户计费
-
-## 4. 私域虚拟人像素材（Asset URL）
-
-**独立端点**：`POST https://api.apimart.ai/v1/seedance2/private-avatar`
-
-| 字段 | 类型 | 说明 |
-|---|---|---|
-| `group` | object | 素材组信息 `{ name, description }`。不传 `group_id` 时服务端按此自动创建 `AIGC` 类型素材组。**与 `group_id` 二选一** |
-| `group_id` | string | 已有素材组 ID，传入时跳过素材组创建。**与 `group` 二选一** |
-| `project_name` | string | 项目名称，默认 `default` |
-| `asset_type` | string | `Image`（默认）/ `Video` / `Audio` |
-| `assets` | array | 素材列表，元素为 `{ url, name }`（`url` 需公网可访问）。**单次最多 20 个** |
-| `url` / `name` | string | 单素材兼容写法，与 `assets` 数组二选一 |
-
-响应：`data.id`（本地任务 ID）、`data.object = "seedance.avatar.asset.task"`、`data.status = "processing"`、`data.progress`、`data.model`。
-
-审核结果同样用 `GET /v1/tasks/{id}` 查询：
-- 批量提交时**只要有一个素材审核失败，任务状态就是 `failed`**，但已通过的素材仍可用，出现在 `result.usable_assets`
-- `result.usable_assets[].asset_url` 可直接用于视频生成
-- `result.failed_assets` 中的素材需更换源文件或重新提交
-- 单素材任务也会兼容返回 `result.asset_url`
-
-审核通过后把 `asset://...` 传入视频生成接口即可；服务端识别到 `asset://` 前缀后**直接提交官方生成任务，不会再次触发素材审核**。
-
-Asset URL 支持全部 Seedance 2.0 模型（`seedance-2.0` / `-fast` / `-mini`）。
-
-## 5. 价格
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) → 视频标签页 `SEEDANCE-2.0`（2026-08-30 复核，1 Credit ≈ $0.1）。当前定价中心与模型页的秒价口径一致，未发现新的价格冲突。
-
-| 规格 | 我们的价格 |
-|---|---|
-| 480P | 0.66 Credits/秒 ≈ **$0.066/秒** |
-| 480P-input | 0.4 Credits/秒 ≈ **$0.04/秒** |
-| 720P | 1.42 Credits/秒 ≈ **$0.142/秒** |
-| 720P-input | 0.8584 Credits/秒 ≈ **$0.08584/秒** |
-| 1080P | 3.544 Credits/秒 ≈ **$0.3544/秒** |
-| 1080P-input | 2.1568 Credits/秒 ≈ **$0.21568/秒** |
-| 4K | 7.22 Credits/秒 ≈ **$0.722/秒** |
-| 4K-input | 4.4432 Credits/秒 ≈ **$0.44432/秒** |
-
-`-input` 档位对应「有参考视频输入」的计费方式（单价更低，但按输入 + 输出总时长计费）。
-
-**数字人（私域人像）另有独立价格** `SEEDANCE-2.0-FACE`：480P 0.992 Credits/秒 ≈ $0.0992/秒、480P-input 0.6 ≈ $0.06/秒、720P 2.136 ≈ $0.2136/秒、720P-input 1.288 ≈ $0.1288/秒、1080P 5 ≈ $0.5/秒、1080P-input 3 ≈ $0.3/秒。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口**有 `seed`**（不下发）；`negative_prompt` 未在参数表列出，但 `nsfw_check` 的审核范围提到了它，接入时按「不注册、不下发」处理。
-- **参数互斥关系是这个模型最容易踩的坑**：`image_urls` / `image_with_roles` 二选一；首尾帧模式下参考视频与参考音频全部失效。UI 必须做互斥禁用，不能只靠后端报错。
-- `generate_audio` **默认 `true`**（会出有声视频），与多数模型默认关闭相反。
-- `1080p` / `4k` **仅标准版支持**，Fast / Mini 传了会失败。
-- 有参考视频时计费按「输入 + 输出总时长」，成本估算不能只按输出时长算。
-- SDK 从 `uploadedVideoFilePaths` / `videos` / `uploadedVideos` 取非空且数量最完整的一组；空数组不遮蔽其他字段。宿主按顺序提供完整 `__videoDurationSeconds: number[]` 时求真实总和，数组不完整时改用 `__totalVideoDurationSeconds`，最后才兼容 `__firstVideoDurationSeconds × 视频数` 的旧近似估算。
-- Asset URL 是一整套独立的素材上传 + 审核流程，若要做数字人必须先接 `private-avatar` 端点。
-
-## 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 | 否 |
-| 定价中心（视频标签页搜 SEEDANCE-2.0 / SEEDANCE-2.0-FACE） | https://apimart.ai/zh/pricing | 否 |
-| API Key 管理 | https://apimart.ai/keys | **是** |
+# Seedance 2.0 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `seedance-2.0`（旧名 `seedance-2-0`） |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> 同一份 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` |
+| `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`（仅标准版）** |
+| `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`（参考人像图，配合 Asset URL）。**与 `image_urls` 不能同时使用** |
+| `video_urls` | string[] | 可选 | — | 参考视频。**最多 3 个，1.8 s < 总时长 < 15.2 s，分辨率需在 480P ~ 720P 之间**。**使用首/尾帧图片时不可用** |
+| `audio_urls` | string[] | 可选 | — | 参考音频。**最多 3 个，总时长 ≤ 15 s**。**必须与参考图片或参考视频一起用**；**使用首/尾帧图片时不可用** |
+| `nsfw_check` | boolean | 可选 | `false` | 见下 |
+
+### 互斥与依赖关系（务必在 UI 层做约束）
+
+- `image_urls` ⊗ `image_with_roles`（二选一）
+- 使用 `image_with_roles` 的首/尾帧时，`video_urls` 与 `audio_urls` **都不可用**
+- `audio_urls` 必须与参考图片或参考视频一起使用
+
+### `nsfw_check` 细节
+
+- 审核范围：文本 `prompt`、`negative_prompt`；图片 `image_urls`、`image_with_roles[].url`、`first_frame_image`、`last_frame_image`；`asset://` 图片素材会反查原始公网 URL 后审核；base64 图片转公网地址后审核
+- **`video_urls`、`audio_urls` 以及视频/音频类型的私域素材不会送审**（审核模型不支持视频和音频）
+- 命中审核时**同步返回 HTTP 400（`nsfw_content_detected`）**，不创建任务、不返回 `task_id`、不扣额度
+- 审核服务不可用/超时/响应异常时采用 **fail-open**（继续提交生成请求），因此**不能作为绝对的内容安全保证**
+- 审核调用本身不向发起视频请求的用户计费
+
+## 4. 私域虚拟人像素材（Asset URL）
+
+**独立端点**：`POST https://api.apimart.ai/v1/seedance2/private-avatar`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `group` | object | 素材组信息 `{ name, description }`。不传 `group_id` 时服务端按此自动创建 `AIGC` 类型素材组。**与 `group_id` 二选一** |
+| `group_id` | string | 已有素材组 ID，传入时跳过素材组创建。**与 `group` 二选一** |
+| `project_name` | string | 项目名称，默认 `default` |
+| `asset_type` | string | `Image`（默认）/ `Video` / `Audio` |
+| `assets` | array | 素材列表，元素为 `{ url, name }`（`url` 需公网可访问）。**单次最多 20 个** |
+| `url` / `name` | string | 单素材兼容写法，与 `assets` 数组二选一 |
+
+响应：`data.id`（本地任务 ID）、`data.object = "seedance.avatar.asset.task"`、`data.status = "processing"`、`data.progress`、`data.model`。
+
+审核结果同样用 `GET /v1/tasks/{id}` 查询：
+- 批量提交时**只要有一个素材审核失败，任务状态就是 `failed`**，但已通过的素材仍可用，出现在 `result.usable_assets`
+- `result.usable_assets[].asset_url` 可直接用于视频生成
+- `result.failed_assets` 中的素材需更换源文件或重新提交
+- 单素材任务也会兼容返回 `result.asset_url`
+
+审核通过后把 `asset://...` 传入视频生成接口即可；服务端识别到 `asset://` 前缀后**直接提交官方生成任务，不会再次触发素材审核**。
+
+Asset URL 支持全部 Seedance 2.0 模型（`seedance-2.0` / `-fast` / `-mini`）。
+
+## 5. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) → 视频标签页 `SEEDANCE-2.0`（2026-08-30 复核，1 Credit ≈ $0.1）。当前定价中心与模型页的秒价口径一致，未发现新的价格冲突。
+
+| 规格 | 我们的价格 |
+|---|---|
+| 480P | 0.66 Credits/秒 ≈ **$0.066/秒** |
+| 480P-input | 0.4 Credits/秒 ≈ **$0.04/秒** |
+| 720P | 1.42 Credits/秒 ≈ **$0.142/秒** |
+| 720P-input | 0.8584 Credits/秒 ≈ **$0.08584/秒** |
+| 1080P | 3.544 Credits/秒 ≈ **$0.3544/秒** |
+| 1080P-input | 2.1568 Credits/秒 ≈ **$0.21568/秒** |
+| 4K | 7.22 Credits/秒 ≈ **$0.722/秒** |
+| 4K-input | 4.4432 Credits/秒 ≈ **$0.44432/秒** |
+
+`-input` 档位对应「有参考视频输入」的计费方式（单价更低，但按输入 + 输出总时长计费）。
+
+**数字人（私域人像）另有独立价格** `SEEDANCE-2.0-FACE`：480P 0.992 Credits/秒 ≈ $0.0992/秒、480P-input 0.6 ≈ $0.06/秒、720P 2.136 ≈ $0.2136/秒、720P-input 1.288 ≈ $0.1288/秒、1080P 5 ≈ $0.5/秒、1080P-input 3 ≈ $0.3/秒。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口**有 `seed`**（不下发）；`negative_prompt` 未在参数表列出，但 `nsfw_check` 的审核范围提到了它，接入时按「不注册、不下发」处理。
+- **参数互斥关系是这个模型最容易踩的坑**：`image_urls` / `image_with_roles` 二选一；首尾帧模式下参考视频与参考音频全部失效。UI 必须做互斥禁用，不能只靠后端报错。
+- `generate_audio` **默认 `true`**（会出有声视频），与多数模型默认关闭相反。
+- `1080p` / `4k` **仅标准版支持**，Fast / Mini 传了会失败。
+- 有参考视频时计费按「输入 + 输出总时长」，成本估算不能只按输出时长算。
+- SDK 从 `uploadedVideoFilePaths` / `videos` / `uploadedVideos` 取非空且数量最完整的一组；空数组不遮蔽其他字段。宿主按顺序提供完整 `__videoDurationSeconds: number[]` 时求真实总和，数组不完整时改用 `__totalVideoDurationSeconds`，最后才兼容 `__firstVideoDurationSeconds × 视频数` 的旧近似估算。
+- Asset URL 是一整套独立的素材上传 + 审核流程，若要做数字人必须先接 `private-avatar` 端点。
+
+## 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 | 否 |
+| 定价中心（视频标签页搜 SEEDANCE-2.0 / SEEDANCE-2.0-FACE） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |