@ apicity/ machgen (英语)

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

安装

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

快速启动

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 询问模型的智能长度.

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。 。 。 .

升级和磨

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

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

定价 列出任务类型 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 返回已完成任务的实际收费.

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 路径 .

资产

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

生成

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

任务

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

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

升级

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

部分 辣点 单相机.

许可证

麻省理工学院——见 自由主义。 。 。 .