# @apicity/machgen 中文文档

规范地址：https://npmcn.com/package/%40apicity/machgen/

版本：0\.27\.0
npm 元数据更新时间：2026-11-06T09:56:41.405Z
中文译文更新时间：2026-11-06T14:15:01.022Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40apicity/machgen
原文对照：https://npmcn.com/package/%40apicity/machgen/?lang=original
项目主页：https://github.com/justintanner/apicity#readme
源码仓库：https://github.com/justintanner/apicity

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

- 包体积（解压后）：118 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：1 个
- 首次发布：2026-10-23T01:25:16.850Z
- 最新版本发布：2026-11-06T09:56:41.194Z
- 近 30 天下载量：3022（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

MachGen视频生成API供应商.

## 安装

```sh
npm install @apicity/machgen
```

也可以使用：`pnpm add @apicity/machgen`、`yarn add @apicity/machgen`、`bun add @apicity/machgen`

## README

# @ apicity/ machgen (英语)

[![npm](https://img.shields.io/npm/v/@apicity/machgen?color=cb0000)](https://www.npmjs.com/package/@apicity/machgen) [![dependencies](https://img.shields.io/badge/dependencies-1-blue)](https://npmcn.com/package/%40apicity/machgen/package.json) [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white)](https://npmcn.com/package/%40apicity/machgen/tsconfig.json) [![docs](https://img.shields.io/badge/docs-machgen.ai-blue)](https://www.machgen.ai/docs/rest_api)

MachGen视频生成API供应商.

图像生成使用相同 `api.v0.generate` 方法: 设置 `task_type` 改为 `T2I` 或者说 `I2I` 供应 `image_config` 与 `height` 和可选 `width`编号 :`aspect_ratio`边框图像 ID 是 `GPT-Image-2`, (中文(简体) ), `GPT-Image-2.5-Sunburst`, (中文(简体) ), `GPT-Image-2.5-Flare`, (中文(简体) ), `Nano-Banana-2` 财务报告和审定财务报表 `Nano-Banana-2.1`编辑时采用公开的 HTTP( S) `src_image_urls`在GPT图像模型上最多16个,在纳米香蕉模型上最多14个(`MACHGEN_I2I_MAX_IMAGES`),或上一个图像 `src_task_ids`. Poll (英语) `api.v0.tasks` 页:1 `task_output.image`. GPT 图像 2 默认为高质量; `optimization_level: "EXPRESS"` 选择低质量。 所记录的1280x544 EXPRESS请求在生成信贷前开具了0.001385美元的账单. 发送 `Alibaba-Wan-3.0` machGen有文件记录的请求 `video_config`数字 : `aspect_ratio: "adaptive"`, (中文(简体) ), `fps: 30` 财务报告和审定财务报表 `audio: true`. 2026-10-22日,7个Wan 3.0任务省略 `aspect_ratio` 财务报告和审定财务报表 `fps` 发送 `audio: false` 被接受,然后在上游失败 `Request Rejected` 以零充电。 随着所记录的配置,2秒480p T2V,I2V和R2V请求完成. MachGen要求的三个领域中哪一个没有被隔离.

运行时间依赖性 :

-   `zod@^4.6.6` - 请求在每一个 POST 端点上附加计划 `.schema`

## 安装

```bash
npm install @apicity/machgen
# or
pnpm add @apicity/machgen
```

## 快速启动

```typescript
import { createMachGen } from "@apicity/machgen";

const machgen = createMachGen({ apiKey: process.env.MACHGEN_API_KEY! });
```

## 视频模型

传出 a `model` 编号为 a `task_type` 它支持我们。 对于下面的ID, `machgen.api.v0.generate.schema` 也检查高度, `duration_secs` 财务报告和审定财务报表 `aspect_ratio` 对照模型的网格(`MACHGEN_VIDEO_GRIDS`,哪个 持有每个 T2V 和 R2V 网格, I2V 框架规则, R2V 参考 限制, UPSCALE 目标`MACHGEN_VIDEO_UPSCALE`和夏尔本 高地(`MACHGEN_VIDEO_SHARPEN`);其他身份识别码未受限制地通过. 马赫金 在HTTP 400接受任务之前用它回答一个离网请求 不开帐单。 网格是从400个回复中读取的 2026-10-25,"迷你麦克斯-H3-Omni"于2026-11-01开机,"SHARPEN"高地开机 2026-10-31. (中文(简体) ). `-1` 询问模型的智能长度.

| 型号 | T2V 电话 | 一、二、五类 | R2车 | 上层 | 沙尔本 | I2V 帧 | I2V高地 | I2V 秒数 | 定价 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `Wan2.2-A14B` | ✓ | ✓ |  |  |  |  | 480,720 (韩语) | 页:1 | T2V, I2V 机车 |
| `LTX-2.3-Pro` | ✓ | ✓ |  |  |  | 开始+结束 | 1080, 1440, 2160 (英语) | 第6、8、10条 | T2V, I2V 机车 |
| `Vidu-Q3-Turbo` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 540,720 (韩语) | 1 - 16岁 | T2V、I2V、R2V |
| `Vidu-Q3-Pro` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 540,720,1080 (英语) | 1 - 16岁 | T2V、I2V、R2V |
| `MiniMax-H3` | ✓ | ✓ | ✓ | ✓ | ✓ | 开始 + 结束,或仅结束 | 480,768,1080,1440 (英语) | 页:1 | T2V, I2V, R2V, UPSCALE, 沙尔本 |
| `MiniMax-H3-Turbo` | ✓ | ✓ | ✓ |  |  | 开始 + 结束,或仅结束 | 480,768,1080 (英语) | 4-15 (中文(简体) ) | T2V、I2V、R2V |
| `MiniMax-H3-Omni` |  |  | ✓ |  |  |  |  |  | R2车 |
| `Seedance-2.5` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 480, 720, 1080 (英语) | 1, 4-30 (英语) | T2V、I2V、R2V |
| `Seedance-2.0` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 480、720、1080、2160 | \-1,415号 | T2V、I2V、R2V |
| `Seedance-2.0-Fast` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 480,720 (韩语) | \-1,415号 | T2V、I2V、R2V |
| `Seedance-2.0-Mini` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 480,720 (韩语) | \-1,415号 | T2V、I2V、R2V |
| `Kling-v3` | ✓ | ✓ |  |  |  | 开始+结束 | 720, 1080, 2160 (英语) | 3-15 (中文(简体) ) | T2V, I2V 机车 |
| `Kling-o3` | ✓ |  | ✓ |  |  |  |  |  | T2V, R2V 机车 |
| `Vidu-Q3` |  |  | ✓ |  |  |  |  |  | R2车 |
| `Vidu-Q4-Preview` |  | ✓ | ✓ |  |  |  | 540、720、1080、1440、2160 | 3 - 16岁 | I2V, R2V 机车 |
| `Vidu-Q3-Pro-Fast` |  | ✓ |  |  |  |  | 720, 1080 (英语) | 1 - 16岁 | 一、二、五类 |
| `Alibaba-Wan-3.0` | ✓ | ✓ | ✓ |  |  | 开始+结束 | 480, 720, 1080 (英语) | \- 1,2-30 (英语) | T2V、I2V、R2V |
| `Veo-3.1` | ✓ |  |  |  |  |  |  |  | T2V 电话 |
| `Veo-3.1-Fast` | ✓ |  |  |  |  |  |  |  | T2V 电话 |
| `Pixverse-V6` | ✓ | ✓ | ✓ |  |  |  | 360、540、720、1080 | 1 - 15个 | T2V、I2V、R2V |
| `Pixverse-C1` | ✓ | ✓ | ✓ |  |  |  | 360、540、720、1080 | 1 - 15个 | T2V、I2V、R2V |
| `HappyHorse-1.1` | ✓ | ✓ | ✓ |  |  |  | 720, 1080 (英语) | 3-15 (中文(简体) ) | T2V、I2V、R2V |
| `HappyHorse-1.0` | ✓ | ✓ | ✓ |  |  |  | 720, 1080 (英语) | 3-15 (中文(简体) ) | T2V、I2V、R2V |
| `Grok-Imagine-Video` | ✓ |  |  |  |  |  |  |  | T2V 电话 |
| `Grok-Imagine-Video-1.5` |  | ✓ |  |  |  |  | 480, 720, 1080 (英语) | 1 - 15个 | 一、二、五类 |
| `Topaz-Video-Precision` |  |  |  | ✓ |  |  |  |  |  |
| `Topaz-Video-Precision-Animation` |  |  |  | ✓ |  |  |  |  |  |
| `Topaz-Video-Generative` |  |  |  | ✓ |  |  |  |  |  |
| `Topaz-Video-Generative-Fast` |  |  |  | ✓ |  |  |  |  |  |

I2V 请求需要一个起始框架 `src_image_urls`。该表的位置 列表“开始 + 结束”,条目1为结束框;“ 仅结束” 表示 `keyframe_indices: [-1]` 动画向一个作为结尾的图像 边框。 马克金也接受 `task_type: "F2F"` 2-图像 I2V schema保留所记录的I2V形式. 迷你Max-H3和迷你Max-H3-Turbo列表 1080p,但MachGen回答403 账户没有访问它 价格簿没有1080p的费率。 价谱的LTX-2.3-Pro 540p和720p 等级不能请求.

### 视频参考

R2V 请求中包含参考图像、视频和音频剪辑 `src_image_urls`, (中文(简体) ), `src_video_urls` (公开https)和 `src_audio_urls`,或较早的产出 `src_task_ids`。 。 。 . `reference_video_start_secs` 列出每个参考视频的第二起. `reference_video_operation` 编辑或扩展视频而不是使用 作为参考; 编辑在视频的长度, 所以MachGen 忽略 `duration_secs`. Minimax-H3-Omni在MachGen的模型中缺失 表格中,但它的模型页和价格簿列出了它,它只需要R2V. 除了下面的封口,每个视频任务最多需要9个图像 `src_image_urls`,用于参考的MachGen 文档限制,以及 大部分3个 `src_video_urls` 财务报告和审定财务报表 `src_audio_urls`。 。 。 .

| 型号 | R2V高地 | R2V 秒数 | 参考资料 | 参考视频 |
| --- | --- | --- | --- | --- |
| `Vidu-Q3-Turbo` | 540,720 (韩语) | 1 - 16岁 | 最多7个图像;无视频或音频 | 无 |
| `Vidu-Q3-Pro` | 540,720 (韩语) | 1 - 16岁 | 最多7个图像;无视频或音频 | 无 |
| `MiniMax-H3` | 480,768,1080,1440 (英语) | 页:1 | 最多9个图像、3个视频、3个音频;共15个 | 引用; 开始冲抵 |
| `MiniMax-H3-Turbo` | 480,768,1080 (英语) | 4-15 (中文(简体) ) | 最多9个图像、3个视频、3个音频;共15个 | 引用; 开始冲抵 |
| `MiniMax-H3-Omni` | 768 (英语) | 1 - 15个 | 最多9个图像、3个视频、3个音频;总共12个;音频需要图像或视频 | 参考文献 |
| `Seedance-2.5` | 480, 720, 1080 (英语) | 1, 4-30 (英语) | 未检查 | 引用、编辑、扩展 |
| `Seedance-2.0` | 480、720、1080、2160 | \-1,415号 | 最多9个图像、3个视频、3个音频;音频需要图像或视频 | 参考文献 |
| `Seedance-2.0-Fast` | 480,720 (韩语) | \-1,415号 | 最多9个图像、3个视频、3个音频;总共12个;音频需要图像或视频 | 参考文献 |
| `Seedance-2.0-Mini` | 480,720 (韩语) | \-1,415号 | 最多9个图像、3个视频、3个音频;总共12个;音频需要图像或视频 | 参考文献 |
| `Kling-o3` | 720, 1080, 2160 (英语) | 3-15 (中文(简体) ) | 最多7个图像;无视频或音频 | 无 |
| `Vidu-Q3` | 540,720,1080 (英语) | 3 - 16岁 | 最多7个图像;无视频或音频 | 无 |
| `Vidu-Q4-Preview` | 540、720、1080、1440、2160 | 3 - 16岁 | 最多3个音频; 没有视频; 未检查图像 | 无 |
| `Alibaba-Wan-3.0` | 480, 720, 1080 (英语) | \- 1,2-30 (英语) | 未检查 | 未检查 |
| `Pixverse-V6` | 360、540、720、1080 | 1 - 15个 | 最多3个图像;没有视频或音频 | 无 |
| `Pixverse-C1` | 360、540、720、1080 | 1 - 15个 | 最多3个图像;没有视频或音频 | 无 |
| `HappyHorse-1.1` | 720, 1080 (英语) | 3-15 (中文(简体) ) | 未检查 | 未检查 |
| `HappyHorse-1.0` | 720, 1080 (英语) | 3-15 (中文(简体) ) | 未检查 | 未检查 |

### 升级和磨

一个 `UPSCALE` 任务重递一个已完成的视频,命名于 `src_task_ids` 或者说 `src_video_urls`,目标 `video_config.height`; 设置 `duration_secs` 到源的长度。 MiniMax- H3 仅升级到自己的尺寸 产出768p为5s或5s以上。 MachGen 也拒绝在 来源的高度,a `gaia-2` 目标超过两倍 源代码, 因此计划无法检查 .

| 型号 | 目标高度 | 发动机 | 定价 |
| --- | --- | --- | --- |
| `MiniMax-H3` | 第1440号 |  | ✓ |
| `Topaz-Video-Precision` | 第1080、1440、2160、4320段 | `artemis-hq`, (中文(简体) ), `artemis-lq`, (中文(简体) ), `artemis-mq`, (中文(简体) ), `gaia-cg`, (中文(简体) ), `gaia-hq`, (中文(简体) ), `proteus` |  |
| `Topaz-Video-Precision-Animation` | 720、960、1080、1440、2160、4320 | `gaia-2` |  |
| `Topaz-Video-Generative` | 1080, 1440, 2160 (英语) | `starlight-hq`, (中文(简体) ), `starlight-mini`, (中文(简体) ), `starlight-precise-2-5`, (中文(简体) ), `starlight-sharp` |  |
| `Topaz-Video-Generative-Fast` | 1080, 1440, 2160 (英语) | `starlight-fast-2` |  |

A 类 `SHARPEN` 任务将一个自有视频磨亮并保持长度: a MachGen 输出命名于 `src_task_ids`,或上传引用为 `@input/<artifact_path>` 内 `src_video_urls`MachGen拒绝公众 URL (中文(简体) ). 这需要 `duration_secs`没有 `num_frames`MachGen的报价 来源的高度和秒, 无论要求的高度或 `duration_secs`设置 `video_config.height` 到源头的高度.

| 型号 | 高地数 | 定价 |
| --- | --- | --- |
| `MiniMax-H3` | 480,768 (英语) | ✓ |

**定价** 列出任务类型 `computeEstimate` 从 `@apicity/cost` 每产出一秒的价格。 一个R2V参考视频 也为秒计费 MachGen从中读取,在任何开始抵消之后,所以通过他们的总数作为 `costHints.inputDurationSeconds`;编辑器的输出也那么长. 一个 以来源的长度为上角的账单,所以它需要相同的提示; 迷你Max -H3开出两秒 磨刀也需要提示 开一分钱 黄玉色的账单 供应商的信用 取决于源的框架和分辨率,所以 `computeEstimate` 已经 不是定价; `api.v0.upscale.quote` 问MachGen的准确价格 `resolveMachGenUpscaleEstimate` 把这个引文变成一个估计. Kling-v3、Kling-o3和Pixverse模型价格音频 分开,就这样 `video_config.audio`。 。 。 . `api.v0.tasks.billing` 返回已完成任务的实际收费.

```typescript
import { createMachGen } from "@apicity/machgen";

const machgen = createMachGen({ apiKey: process.env.MACHGEN_API_KEY! });

const task = await machgen.api.v0.generate({
  model: "MiniMax-H3-Turbo",
  task_type: "I2V",
  prompt: "The cat slowly blinks and turns its head toward the window.",
  video_config: { height: 480, duration_secs: 4 },
  src_image_urls: [
    "https://example.com/start.jpg",
    "https://example.com/end.jpg",
  ],
});

let status = await machgen.api.v0.tasks(task.task_id);
while (status.status === "PENDING" || status.status === "RUNNING") {
  await new Promise((resolve) => setTimeout(resolve, 10_000));
  status = await machgen.api.v0.tasks(task.task_id);
}
const bill = await machgen.api.v0.tasks.billing(task.task_id);
console.log(bill.generation_cost_micros / 1e6); // 0.06
```

## API 参考

5个端点跨出4个组. 每个方法都映射出上游的 URL 路径 .

### 资产

`GET` **`machgen.api.v0.assets`**

`GET https://api.machgen.ai/api/v0/assets/{taskId}`

成本等级 : `expensive`

[上游区域](https://www.machgen.ai/docs/rest_api#check-status-and-download)

```typescript
const res = await machgen.api.v0.assets({ /* ... */ });
```

资料来源: [`packages/provider/machgen/src/machgen.ts`](https://npmcn.com/package/%40apicity/machgen/src/machgen.ts)

### 生成

`POST` **`machgen.api.v0.generate`**

`POST [https://api.machgen.ai/api/v0/generate](https://api.machgen.ai/api/v0/generate)`

成本等级 : `expensive`

[上游区域](https://www.machgen.ai/docs/rest_api#submit-a-task)

```typescript
const res = await machgen.api.v0.generate({ /* ... */ });
```

资料来源: [`packages/provider/machgen/src/machgen.ts`](https://npmcn.com/package/%40apicity/machgen/src/machgen.ts)

### 任务

`GET` **`machgen.api.v0.tasks`**

`GET https://api.machgen.ai/api/v0/tasks/{taskId}`

成本等级 : `expensive`

[上游区域](https://www.machgen.ai/docs/reference#taskstatusresponse)

```typescript
const res = await machgen.api.v0.tasks({ /* ... */ });
```

资料来源: [`packages/provider/machgen/src/machgen.ts`](https://npmcn.com/package/%40apicity/machgen/src/machgen.ts)

`GET` **`machgen.api.v0.tasks.billing`**

`GET https://api.machgen.ai/api/v0/tasks/{taskId}/billing`

成本等级 : `expensive`

[上游区域](https://www.machgen.ai/docs/rest_api#check-what-a-task-cost)

```typescript
const res = await machgen.api.v0.tasks.billing({ /* ... */ });
```

资料来源: [`packages/provider/machgen/src/machgen.ts`](https://npmcn.com/package/%40apicity/machgen/src/machgen.ts)

### 升级

`POST` **`machgen.api.v0.upscale.quote`**

`POST [https://api.machgen.ai/api/v0/upscale/quote](https://api.machgen.ai/api/v0/upscale/quote)`

成本等级 : `expensive`

> **未记录的上游 :** MachGen的REST docs没有列出这个终点(读作2026-10-26),因此MachGen可以不经通知而更改或去除. MachGen的网络应用软件在提交前会随其升级价格,MCP服务器的 `quote_video_upscale` 工具 ([文档](https://www.machgen.ai/docs/mcp#tools))是同一支票的记载形式。 引用是免费的,没有创建任务和答案 `{ cost_micros }`,微额美元,你拥有的源的升级 将会开出账单; 记录的黄玉色升级 准确的开出报价。 2026-10-26日,一款2160p Topaz Video Generative Fast上调了4 s 480p任务,引用了596,000个微分(录制) `machgen/topaz-video-generative-fast-upscale-quote`) (中文(简体) ). `resolveMachGenUpscaleEstimate` 内 `@apicity/cost` 将引用变成估计.

```typescript
const res = await machgen.api.v0.upscale.quote({ /* ... */ });
```

资料来源: [`packages/provider/machgen/src/machgen.ts`](https://npmcn.com/package/%40apicity/machgen/src/machgen.ts)

部分 [辣点](https://github.com/justintanner/apicity) 单相机.

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40apicity/machgen/LICENSE)。 。 。 .

## 常见问题

### @apicity/machgen 是什么？

MachGen视频生成API供应商\.

### 如何安装 @apicity/machgen？

在项目目录运行 npm install @apicity/machgen，或使用 pnpm add / yarn add / bun add。

### @apicity/machgen 支持 TypeScript 吗？

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

### @apicity/machgen 支持 ESM 还是 CommonJS？

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

### @apicity/machgen 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @apicity/machgen 可以商用吗？

@apicity/machgen 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @apicity/machgen 的下载量有多少？

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

### @apicity/machgen 还在维护吗？

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