Topaz Astra 2 视频超分

topaz/astra-2

使用 Topaz Astra 2 增强并超分视频。上传源视频后，可选择目标分辨率，并调整创造性、锐化、真实感、动态压缩、编码、音频处理和输出格式。

示例

参数

名称	类型	默认	约束	说明
resolution *输出分辨率	select	1080p	1080p \| 4k	按 Topaz Astra 2 官方价格档位选择输出分辨率。
prompt提示词	textarea	—	≤ 1000 chars	可选填写，用于指导视频增强方向。
creativity创造性	slider	0.4	0 ~ 1 · step 0.05	值越高，模型越可能补充新的细节；值越低，越贴近原视频。
sharp锐化	slider	0.5	0 ~ 1 · step 0.05	控制输出视频的锐化强度。
realism真实感	slider	0.7	0 ~ 1 · step 0.05	控制增强结果的真实感倾向。
dynamic_compression_level动态压缩	select	High	Low \| Mid \| High	选择视频处理时应用的动态压缩等级。
video_encoder视频编码	select	H264	H264 \| H265	选择输出视频使用的编码格式。
video_profile编码档位	select	High	Baseline \| Main \| High	选择 H.264 或 H.265 的编码档位。
audio_transfer音频处理	select	Copy	Copy \| Encode	保留原始音频，或重新编码为 AAC。
output_container输出格式	select	mp4	mp4	选择生成视频的封装格式。

API

通过统一 REST API 调用本模型；在 API Keys 页获取密钥。

cURL

# 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"

Python

import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/topaz/astra-2",
    headers=HEADERS,
    json={
        "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"
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))

JavaScript

const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/topaz/astra-2", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

文档

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