如何使用 Topaz Astra 2 视频超分 API:视频转视频接入指南(2026)
Topaz Astra 2 视频超分 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
Topaz Astra 2 视频超分 是一款视频转视频模型(由 Topaz 提供):使用 Topaz Astra 2 增强并超分视频。上传源视频后,可选择目标分辨率,并调整创造性、锐化、真实感、动态压缩、编码、音频处理和输出格式。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.480。
TL;DR
· 任务类型:视频转视频,由 Topaz 提供
· 价格:典型一次约 $0.480($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:10 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 Topaz Astra 2 视频超分 能做什么?
短视频与广告片段:从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览:低成本验证分镜和视觉方向,再决定是否实拍。
社媒内容工厂:批量生成竖屏短片,配合热点话题快速上线。
已有素材的二次创作:图生视频让静态作品动起来,延长内容生命周期。
怎么调用这个 API?
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/topaz/astra-2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"resolution": "1080p",
"creativity": 0.4,
"sharp": 0.5,
"realism": 0.7,
"dynamic_compression_level": "High",
"video_encoder": "H264",
"video_profile": "High",
"audio_transfer": "Copy",
"output_container": "mp4"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数?
resolution(输出分辨率):必填,默认 "1080p"
prompt(提示词):可选
creativity(创造性):可选,默认 0.4
sharp(锐化):可选,默认 0.5
realism(真实感):可选,默认 0.7
dynamic_compression_level(动态压缩):可选,默认 "High"
video_encoder(视频编码):可选,默认 "H264"
video_profile(编码档位):可选,默认 "High"
audio_transfer(音频处理):可选,默认 "Copy"
output_container(输出格式):可选,默认 "mp4"
Topaz Astra 2 视频超分 的提示词怎么写?
1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $0.480($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
Topaz Astra 2 视频超分
Topaz Astra 2 可在尽量保留原视频运动和画面结构的同时增强并放大视频,适用于改善模糊素材、提高交付分辨率,以及为大屏播放准备视频。
输入与输出
- 通过
video_url提供可访问的 MP4、MOV 或 MKV 视频,文件最大 5 GB。 resolution可选1080p或4k。- 任务完成后,增强视频 URL 会通过
videos数组返回。
参数
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
video_url | 是 | - | 源视频 URL 或已上传的视频。 |
resolution | 是 | 1080p | 输出分辨率,可选 1080p 或 4k。 |
prompt | 否 | 空 | 对增强细节或风格的文字指导,最多 1,000 字符。 |
creativity | 否 | 0.4 | 范围 0〜1;数值越高,越可能补充新的细节。 |
sharp | 否 | 0.5 | 范围 0〜1;控制锐化强度。 |
realism | 否 | 0.7 | 范围 0〜1;控制增强结果的真实感。 |
dynamic_compression_level | 否 | High | 动态压缩等级:Low、Mid 或 High。 |
video_encoder | 否 | H264 | 输出编码:H264 或 H265。 |
video_profile | 否 | High | 编码档位:Baseline、Main 或 High。 |
audio_transfer | 否 | Copy | Copy 保留原音频,Encode 重新编码音频。 |
output_container | 否 | mp4 | 输出封装格式,当前为 mp4。 |
计费
按检测到的源视频时长计费,不足 1 秒的部分向上取整到下一整秒,最低按 1 秒计费。
| 分辨率 | 每个计费秒价格 |
|---|---|
| 1080p | 48 credits |
| 4K | 80 credits |
例如,1.2 秒视频按 2 秒计算:1080p 为 96 credits,4K 为 160 credits。
FAQ
可以先免费试用吗?+
注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。
生成内容可以商用吗?有水印吗?+
可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。
内容政策是什么?+
NamiFusion 是无过滤引擎,不做武断限制、对 NSFW 友好,但禁止违法内容与非自愿的真人素材,详见服务条款。
Topaz Astra 2 视频超分 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。