image_urlTopaz Upscale Precision API — 如何接入并付费
通过 Flow 使用 Topaz Precision Upscale(Standard V2、High Fidelity V2/V3、Low Resolution V2、CGI、Text Refine、Faces)——忠实放大,不生成额外细节,输出最高可达 512 MP,适用于印刷。按输出每 24 MP 计费,不足 24 MP 按 24 MP 计;source_megapixels 和 output_megapixels 为必填参数,upscale_factor 为 1–4 的放大倍数,可取小数。
组合你需要的输出结果
topaz-upscale-precision该模型在目录中仅公布最低价格。
什么是 Topaz Upscale Precision
通过 Flow 使用 Topaz Precision Upscale(Standard V2、High Fidelity V2/V3、Low Resolution V2、CGI、Text Refine、Faces)——忠实放大,不生成额外细节,输出最高可达 512 MP,适用于印刷。按输出每 24 MP 计费,不足 24 MP 按 24 MP 计;source_megapixels 和 output_megapixels 为必填参数,upscale_factor 为 1–4 的放大倍数,可取小数。
契约概览
- 输入
- image
- 输出
- image
- 模式
- 异步(任务 + 轮询)
- 状态轮询
- 每 3 秒 · 最多 90 秒
优势
- 定价:按图像计费
- 输入:图像
- 7 个可配置选项
- 用于媒体生成的一个 API 密钥
应用场景
- 文章和社交媒体插图
- 产品图像
- 横幅和封面
- 设计原型
API 契约
生成是异步的:先创建任务,然后轮询状态直至完成。
- 创建任务
- POST /api/media/generate
- 检查状态
- GET /api/media/jobs/{jobId}
- 输入
- image
- 输出
- image
- 轮询
- 每 3 秒 · 最多 90 秒
- 鉴权
- Authorization: Bearer sk-pv-…
请求示例
在 Bearer 请求头中传递密钥。API 会返回 jobId 用于轮询状态。
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"topaz-upscale-precision","opts":{"image_url":"https://example.com/image_url.png","model":"Standard V2","source_megapixels":1,"output_megapixels":4,"upscale_factor":2,"output_format":"jpeg","face_enhancement":true}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "topaz-upscale-precision",
"opts": {
"image_url": "https://example.com/image_url.png",
"model": "Standard V2",
"source_megapixels": 1,
"output_megapixels": 4,
"upscale_factor": 2,
"output_format": "jpeg",
"face_enhancement": true
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API 请求参数
通过 GetVibe API 向 Topaz Upscale Precision 发起请求的参数。
modelsource_megapixels必填output_megapixels必填upscale_factoroutput_formatface_enhancementimage_file_idimage_base64| 参数 | 类型 | 取值 | 默认值 | 价格 |
|---|---|---|---|---|
image_url | URL | Public image URL | — | — |
model | option selection | Standard V2 (default) · High Fidelity V2 · High Fidelity V3 · Low Resolution V2 · CGI · Text Refine · Faces | Standard V2 | Included in the base price |
source_megapixels必填 | text / number | any value | — | Included in the base price |
output_megapixels必填 | text / number | any value | — | Included in the base price |
upscale_factor | text / number | any value | — | Included in the base price |
output_format | option selection | JPEG (default) · PNG | JPEG | Included in the base price |
face_enhancement | yes/no | Yes (default) · No | 是 | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
请求:POST https://getvibeapi.com/api/media/generate。价格以 USD 计。
Topaz Upscale Precision 的价格
Topaz Upscale Precision 的费用:从 $0.106667 per image。价格按当前汇率动态计算,最终扣费见 API 响应(priceRub)。以 USD 支付,无订阅。
默认请求的实际费用
若不传参数,请求将使用这些取值:Topaz model — Standard V2, Format — JPEG, Face enhancement — Yes。 该请求的费用为 $0.106667。
README
Topaz Upscale Precision 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。
# Topaz Upscale Precision
公开模型:topaz-upscale-precision
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}
## 输入参数
- `image_url` (URL): Public image URL; 默认: —
- `model` (option selection): Standard V2 (default) · High Fidelity V2 · High Fidelity V3 · Low Resolution V2 · CGI · Text Refine · Faces; 默认: Standard V2
- `source_megapixels` (text / number): any value; 默认: —
- `output_megapixels` (text / number): any value; 默认: —
- `upscale_factor` (text / number): any value; 默认: —
- `output_format` (option selection): JPEG (default) · PNG; 默认: JPEG
- `face_enhancement` (yes/no): Yes (default) · No; 默认: Yes
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; 默认: —
## 公开变体
- `topaz-upscale-precision`: 默认关于 Topaz Upscale Precision API 的常见问题
Topaz Upscale Precision 的价格是多少?
Topaz Upscale Precision 的价格:从 $0.106667 per image。价格按当前汇率动态计算。
是否兼容 OpenAI SDK?
是的,API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。