Replicate 在线 API：脚本调用 CodeFormer 批量跑

Replicate 是什么

Replicate 是一个 AI 模型托管平台，模型作者可以把自己的模型发布上去，用户通过网页 UI 或 API 调用，按使用量计费。

CodeFormer 在 Replicate 上有官方端点（由作者维护）：sczhou/codeformer。

网页 UI 体验

打开 replicate.com/sczhou/codeformer：

1. 左侧上传图片或视频
2. 调参数（w、背景增强、对齐等）
3. 点击 Run
4. 下载结果

和 HuggingFace Demo 相比，Replicate 的优势是支持视频输入，而且处理速度通常比免费 HuggingFace Space 快（付费优先级）。

CLI 调用

# 安装 replicate CLI
pip install replicate

# 设置 API Token（在 replicate.com/account 创建）
export REPLICATE_API_TOKEN=r8_xxx

# 跑单张图片，w=0.7
replicate run sczhou/codeformer -i image=@photo.jpg -i w=0.7 -i upscale=2 --output out.jpg

Python API 调用

import replicate

# API Token 在环境变量里设置
client = replicate.Client(api_token="r8_xxx")

# 运行
output = client.run(
    "sczhou/codeformer",
    input={
        "image": open("photo.jpg", "rb"),
        "w": 0.7,
        "upscale": 2,
        "has_aligned": False,
        "bg_upsampler": "realesrgan",
        "face_upsample": True,
    }
)

# 下载结果
import requests
result_url = output  # 返回的是输出图的 URL
resp = requests.get(result_url)
open("result.jpg", "wb").write(resp.content)

视频输入

Replicate 端点支持视频（mp4/mov/avi）：

output = client.run(
    "sczhou/codeformer",
    input={
        "image": open("clip.mp4", "rb"),  # 视频文件同样用 image 参数
        "w": 1.0,
        "upscale": 2,
    }
)

注意：视频处理时间长，按秒计费的话可能要几美元一次。

费用

Replicate 按运行时长秒数计费。CodeFormer 的单次推理成本大约：

• 单张图片：$0.001 ~ $0.005
• 10 秒视频：$0.05 ~ $0.15

具体价格在 Replicate 模型页面有公示。相比自建 GPU 服务器，小批量用 Replicate 更划算。

适合什么

• 需要在代码里调用人脸修复能力（网站后端、桌面应用）
• 不想管 GPU 运维
• 偶尔处理几张图 / 几段视频（不够自建门槛）

不适合什么

• 大批量（几千张以上）：成本会比自建 GPU 高
• 敏感数据：图片会上传到 Replicate 服务器
• 离线环境：需要联网

其他 API 平台

GitHub README 还列出了多个非官方 API 平台：Segmind、Sieve、Fal.ai、VaikerAI、Scade.pro 等。这些平台可能价格更低或有特殊功能，但注意：

• 都不是 CodeFormer 作者维护的
• 模型可能不是最新版本
• 遇到质量问题无法找作者

选择建议：生产环境用官方端点（Replicate），测试可以随便试。