企业官网建设流程全解析

treg图片视频生成API完全指南：6步调用Replicate、MiniMax等供应商模型无需申请密钥

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg

想调用 Replicate 的 FLUX 生图或 MiniMax 的 Hailuo 生视频，却不想逐个注册供应商账号、分别充值和保存一堆 API 密钥？treg 图片视频生成 API 把这件事变成了一条命令：用一个统一令牌，按次付费调用 3,000+ 个工具端点，覆盖 60+ 供应商，图像与视频生成工具从每张 0.003 美元起算。本文为新手梳理从选模型、下调用、等待异步任务到托管参考图的完整流程，6 步即可跑通第一次生成。

一、treg 是什么：为什么它能省掉一堆供应商密钥

treg 定位是“工具界的 OpenRouter”：你不直接对接每家厂商的 API，而是通过 treg 的统一入口调用。对图片视频生成场景，它内置了image-gen（生图）与video-gen（生视频）两大平台分类，并维护了各家模型的价格表。

关键机制是凭证阶梯，treg 按顺序选择：

1. 你的团队自己注册了该供应商的工具 → 用你的密钥（永不扣余额）；
2. 团队存过该供应商的密钥 → 服务端注入，同样免费；
3. 端点有已验证的公开路由 → 无需任何供应商密钥，直接调用；
4. 以上都不满足 → 用 treg 自己的密钥，从团队预存余额中按次扣费。

也就是说，没有 Replicate 账号也能用，余额不足时接口会返回 402 并附带预计费用，方便程序化处理。详细背景见 README.md。

二、先查有哪些图片视频生成模型可用

treg 的目录文件按供应商组织，每家模型的参数和价格都写在里面。核心供应商对应文件：

• Replicate（FLUX、GPT Image、Nano Banana Pro、Seedance、Veo 3.1 Fast 等）：replicate.yaml
• MiniMax（Hailuo 视频、image-01 生图）：minimax.yaml
• OpenRouter（Wan 3.0、Seedance 2.5 视频）：openrouter.yaml

更完整的厂商与模型盘点可参考 aigc-model-landscape.md。部分已验证价格（按成功计费，失败自动退还预留金额）：

用一行命令按“能做什么”搜索，而不是记供应商名字：

treg catalog search "generate video from text"

三、生图最快上手：3 条命令出第一张图

以 FLUX Schnell 为例，先看价格再花钱：

# 1. 查看端点参数、价格、示例响应 treg catalog get replicate.image-gen.flux-schnell # 2. 发起调用（POST 一个 JSON 请求体） treg call replicate.image-gen.flux-schnell --method POST \ --data '{"input":{"prompt":"A small red kite above a calm beach."}}' # 3. 查看这次花了多少钱 treg balance

生图任务返回的output字段就是图片 URL。注意供应商的结果链接通常有时效，请及时下载，treg 本身不存储生成的媒体文件。

四、生视频怎么调：--await 自动等待异步任务 🎬

视频生成是异步任务：提交后供应商返回任务 ID，treg 按各供应商节奏（Replicate 2 秒、MiniMax 10 秒、OpenRouter 30 秒）轮询直到完成。CLI 的--await参数替你完成整个等待过程：

treg call replicate.video-gen.veo-3.1-fast --method POST \ --data '{"input":{"prompt":"A paper boat crosses a quiet pond.","duration":4,"resolution":"720p","aspect_ratio":"16:9","generate_audio":false}}' \ --await

几个新手必知的细节（摘自 USAGE.md）：

• 计费规则：提交时预留资金，只有任务成功才真正扣费，失败自动退还；
• 退出码：0 = 完成，2 = 供应商任务失败，3 = 超时——超时后终端会打印一条可复制的恢复命令，继续等待即可，不会重复收费；
• 时长预期：一条视频通常要 1~5 分钟，若在 AI 编码代理中运行，请调大 shell 工具超时或放后台执行；
• 审计：treg audit可回看每个任务的状态。

这类“脚本 + 生成视频”正是典型玩法：用生成 API 批量产出 UGC 风格的营销短片，无需摄影棚与剪辑师。

五、常见坑：图生视频、图片编辑的“参考图”从哪来

图生视频（Hailuo image-to-video、GPT Image 编辑）要求传入供应商能直接下载的公网图片 URL。自己电脑上的本地文件不满足条件——treg host就是为此设计的免费托管：

treg host ./first-frame.png # 打印一个公网 URL，填进请求体的 image 字段即可

它的边界很清晰：单文件 30 MB、每组织每日 300 MB、7 天有效期、仅收图片/音频/视频，且不计费。技术细节见 media.md。

六、把 treg 接进你的 AI 代理：让 Agent 自己会生成 🤖

如果你不是手敲命令，而是让 Claude Code 之类的编码代理干活，treg 提供三种接入方式：

• CLI 技能：安装后技能会自动引导代理完成登录与后续调用；
• MCP 服务：treg mcp install后，代理直接把 treg 目录当成一组工具来发现和调用；
• 代理插件：随插件市场一键安装，无需任何令牌配置。

接入后的体验是“用自然语言下任务”：“给这个产品生成一张 16:9 的宣传图”——代理自己检索目录、挑选模型、组装请求、等待结果。若你已有付费的 Replicate 或 MiniMax 密钥，用treg secret add存入团队后，你的密钥永远优先于 treg 的，且这部分调用完全不计费。

常见问题速答

小结：treg 图片视频生成 API 的核心价值是把“N 家供应商、N 套密钥、N 份账单”压缩成“一个令牌、按次计费、一条命令”。先用treg catalog search找能力、treg catalog get看价格，再用treg call --await出结果——生图几秒，生视频几分钟，成本从美分级开始。

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg