# @antseed/provider-venice-video 中文文档

规范地址：https://npmcn.com/package/%40antseed/provider-venice-video/

版本：0\.1\.16
npm 元数据更新时间：2026-11-07T14:27:40.645Z
中文译文更新时间：2026-11-06T19:09:44.493Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40antseed/provider-venice-video
原文对照：https://npmcn.com/package/%40antseed/provider-venice-video/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：111 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@antseed/node \>=0\.1\.0
- 首次发布：2026-10-08T05:34:15.145Z
- 最新版本发布：2026-11-07T14:27:40.443Z
- 近 30 天下载量：2743（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

威尼斯视频 API 中继 AntSeed

## 安装

```sh
npm install @antseed/provider-venice-video
```

也可以使用：`pnpm add @antseed/provider-venice-video`、`yarn add @antseed/provider-venice-video`、`bun add @antseed/provider-venice-video`

## README

# @antseed/producer-venice-video (英语)

中继威尼斯本土视频请求威尼斯API.

## 配置

```bash
antseed plugin add @antseed/provider-venice-video
export VENICE_VIDEO_API_KEY=<seller-api-key>
```

-   `VENICE_VIDEO_API_KEY`: 威尼斯 API 密钥,作为无记名符号发送
-   `VENICE_VIDEO_BASE_URL`: 可选,默认为 `https://api.venice.ai`
-   `ANTSEED_ALLOWED_SERVICES`:威尼斯视频模型名称
-   `ANTSEED_SERVICE_UNIT_BILLING_MODELS_JSON`数字 : `venice-video` 使用 `video_generations` 或者说 `video_seconds`
-   `ANTSEED_SERVICE_CAPABILITIES_JSON`: 广告的可选视频选项
-   `VENICE_VIDEO_MIN_BALANCE_USD`: 可选,默认 `0`. 当钥匙的威尼斯余额(美元 + DIEM + 捆绑入计量)处于或低于时,模型停止广告

每次销售者健康检查都要进行两次免费检查。 账户检查显示 `GET /api/v1/api_keys/rate_limits` (钥匙,接入,平衡):一个被否决的钥匙,被封杀的接入,或者至少一个平衡停止了每个被广告的模型. 模型检查读取了威尼斯的公众号 `GET /api/v1/models?type=video`:一个威尼斯模式不再列出停止广告. 名单不与密钥的视频请求限制相抵. 一个模型再次公布 两次检查合格。 两者都不产生媒体.

威尼斯的模型列表没有说明哪个图像到视频模型接受最后一个帧,因此销售商在起动时询问威尼斯. 对于没有配置的每个图像到视频模型 `video.inputs`,它发出一个创造,威尼斯必须拒绝(空的即时,不可能持续的时间). 威尼斯列出了所有的问题 `400` 答案和名称 `end_image_url` 当模型无法使用, 所以检查开始没有工作, 花费什么。 模特儿威尼斯不反对宣布 `end_image_url`. 检查进度加快,只听从威尼斯的40个视频请求一分钟;一个不明确的答案只宣布第一帧. 要跳过检查或要求帧,请亲自宣布:

```json
{
  "seedance-2-0-image-to-video-basic": {
    "video": { "inputs": ["first_frame", "last_frame"], "requiredInputs": ["first_frame"] }
  },
  "pixverse-c1-transition": {
    "video": { "inputs": ["first_frame", "last_frame"], "requiredInputs": ["first_frame", "last_frame"] }
  }
}
```

与 `antseed seller start`,将每个服务设置为 `seller.providers.<name>.services.<id>.capabilities`。 。 。 .

初起销售者阅读了威尼斯的视频模型列表(`GET /api/v1/models?type=video`)并宣布每个模型的队列字段为 `supportedParameters`数字 : `prompt`, (中文(简体) ), `duration`, (中文(简体) ), `resolution` 财务报告和审定财务报表 `aspect_ratio` 当模型列出值时, `audio` 当它是可配置的, 和框架字段 `video.inputs` 您将宣布(`image_url`, (中文(简体) ), `end_image_url`, (中文(简体) ), `reference_image_urls`) (中文(简体) ). 当你宣布无,图像到视频模型 `image_url`附加时 `end_image_url` 当启动检查说模型需要最后一个框架时. 买家只寄出列出的田地. 一个服务设置 `supportedParameters` 自己留着 如果列表无法被读取或不包含模型,则在不包含该模型的情况下宣布服务.

### 光谱比和音频

威尼斯按其外观比和音频以及分辨率和持续时间定价一个剪辑(例如4s的种子2.5:480p:16:9:0.51;21:9:0.67;没有音频的Veo 3.1费用减少)。 用匹配的组件来定价 `aspect_ratio` 财务报告和审定财务报表 `audio` (单位:千美元)`"true"` 编号 : `"false"`旁边 `resolution` (元数据 v16,每个模型最多64个组件),例如:

```json
{ "unit": "video_seconds", "priceUsd": 0.0701, "match": { "resolution": "480p", "aspect_ratio": "16:9", "audio": "true" } }
```

买家给一个没有的创造定价 `aspect_ratio` 在第一个宣布, 和一个漏出 `audio` 时间 `video.audio`,插件发出同样的威尼斯:

-   `video.aspectRatios`: 与另一个创建 `aspect_ratio` 已回答 `422 unsupported_video_option` 在支付之前,不给威尼斯打电话。 与第一个列表一起发送一个没有列表的创建 .
-   `video.audio`数字 : `false` 拒绝 `audio: true` 对于一个能让你关掉威尼斯音乐的模特来说`audio_configurable`),发送 `audio: false` 当创建者将其删除时( Venice 默认添加音频) 。 虽然威尼斯的模型列表还没有被读取(或者缺少模型),但是一个没有 `audio` 而是被拒绝,所以它必须说 `audio: false`。 。 。 .

一个服务 `video.audio: true` 接受 `audio: false`;如果威尼斯的收费少的话,给它自己的价格. 您不宣布的选项按发送方式转发 .

### 视频编辑

模范威尼斯标记 `video_input` (例如 `minimax-h3-max-recast`, (中文(简体) ), `kling-v3-standard-motion-control`, (中文(简体) ), `wan-2-7-video-to-video`)将源视频作为 `video_url`. 对于每一个,卖方宣布 `video` 财务报告和审定财务报表 `reference_image` 内 `video.inputs`,以及 `video_url` 财务报告和审定财务报表 `image_url` (动作控制字符;威尼斯在每一个编辑模型上接受) `supportedParameters`。要了解模型是否接收参考图像,它发送一个创建的威尼斯必须拒绝(空) `reference_image_urls`,不可能持续). 威尼斯回答道,需要参考,不支持,或者说什么都不说,什么也没有排队. 需要的公布于 `video.requiredInputs`后加 `reference_image_urls`. 宣布 `video.inputs` 你跳过这个支票。 销售者还宣布每个编辑模型的 `resolutions` 从威尼斯的模型列表, 在威尼斯的情况.

买方支付 `duration`。威尼斯单列编辑列表 `Auto` 整个源的长度,输出短于 `duration` 从不收费,所以每个编辑模型 卖方测量源和答案 `422 invalid_video_duration`在支付之前,不给威尼斯打电话,除非 `duration` 以整秒表示的源长度, 四舍五入( 例如) `"6s"` 用于6.2 s 来源。 来源必须是内在的(`data:video/mp4;base64,...`) (中文(简体) ). 否则,卖方不会检查来源;威尼斯会。 威尼斯在排队后拒绝的工作(例如,在没有一个人的视频上移动控制或重播,或来源太短)在检索时用JSON进行回答 `400`编号 :`422`。插件将它变成 `{"status":"FAILED","error":"<reason>"}`,因此该工作的支付渠道立刻关闭,而不是到期时关闭. 威尼斯用 HTML 回答一个高于 32.5 MB 的天体 `413`; 插件将它变成 JSON `413 request_too_large`。 。 。 .

插件继电器 `POST /api/v1/video/queue` 不变,除了上面宣布的选项,并处理 `POST /api/v1/video/retrieve` 通过返回威尼斯JSON状态或通过销售者流出完成的MP4. 对于私人模特来说,威尼斯会回归短暂的生命 `download_url` ; 插件从买家的回复中删除, 保存24小时, 一旦检索报告, 文件就会流出 `COMPLETED`. 将 URL 保存在卖方的数据目录中(`venice-video-download-urls.json`设置 `ANTSEED_DATA_DIR`,哪个 `antseed seller start` 因此,他们活过一个卖家重启。 其他威尼斯模型元数据没有执行. `POST /api/v1/video/complete` 未转发.

检查威尼斯的条件允许你献礼 蚂蚁种子销售者必须增加价值,而不是转售原始API访问.

## 常见问题

### @antseed/provider-venice-video 是什么？

威尼斯视频 API 中继 AntSeed

### 如何安装 @antseed/provider-venice-video？

在项目目录运行 npm install @antseed/provider-venice-video，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@antseed/node（\>=0\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @antseed/provider-venice-video 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @antseed/provider-venice-video 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @antseed/provider-venice-video 可以商用吗？

@antseed/provider-venice-video 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @antseed/provider-venice-video 的下载量有多少？

根据 npm 官方下载统计，@antseed/provider-venice-video 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,743 次，日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @antseed/provider-venice-video 还在维护吗？

最新版本 0\.1\.16 发布于 2026/11/07（今天）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

