Topaz API
Topaz API trên WaveSpeedAI — các mô hình cải thiện ảnh của Topaz Labs dưới dạng endpoint REST: Sharpen cho mờ do ống kính và chuyển động, Denoise cho hạt nhiễu và nhiễu ISO cao, Restore cho bụi và vết xước trên ảnh cũ, và Lighting cho độ phơi sáng, cân bằng trắng và màu sắc.
Gửi một ảnh JPEG hoặc PNG và nhận lại ảnh đã được cải thiện: làm nét ảnh mềm hoặc lệch nét, làm sạch ảnh thiếu sáng nhiều nhiễu, loại bỏ bụi và vết xước khỏi ảnh in đã quét, hoặc chỉnh độ phơi sáng và nhiệt độ màu. Mỗi endpoint nhận ảnh, lựa chọn mô hình và định dạng đầu ra, trên cùng luồng dự đoán REST như mọi mô hình khác trên WaveSpeedAI.
/filters:quality(82)/examples/f1eed2a7bfe888eb867d726036d8a338/1783683950126693744_2rEOX7gp.webp)
Tổng quan
Giới thiệu về Topaz API
Topaz làm được gì, nằm ở đâu trong dòng mô hình của Topaz Labs, và vì sao các đội ngũ chọn nó.
Topaz là mô hình nâng cấp bằng AI từ Topaz Labs, có sẵn qua REST API của WaveSpeedAI. Topaz API trên WaveSpeedAI — các mô hình cải thiện ảnh của Topaz Labs dưới dạng endpoint REST: Sharpen cho mờ do ống kính và chuyển động, Denoise cho hạt nhiễu và nhiễu ISO cao, Restore cho bụi và vết xước trên ảnh cũ, và Lighting cho độ phơi sáng, cân bằng trắng và màu sắc.
Gửi một ảnh JPEG hoặc PNG và nhận lại ảnh đã được cải thiện: làm nét ảnh mềm hoặc lệch nét, làm sạch ảnh thiếu sáng nhiều nhiễu, loại bỏ bụi và vết xước khỏi ảnh in đã quét, hoặc chỉnh độ phơi sáng và nhiệt độ màu. Mỗi endpoint nhận ảnh, lựa chọn mô hình và định dạng đầu ra, trên cùng luồng dự đoán REST như mọi mô hình khác trên WaveSpeedAI.
Họ Topaz trên WaveSpeedAI cung cấp 17 endpoint REST bao gồm 4 quy trình Video-Tools, Upscale-Video, Upscale-Image, Image-Tools. Mỗi biến thể có giá, các tham số điều chỉnh và kết quả mẫu riêng — hãy chọn biến thể phù hợp với dạng đầu vào và ràng buộc sản xuất của bạn, hoặc gọi nhiều biến thể từ cùng một API key để ghép các pipeline nhiều bước.
Chạy Topaz bằng cùng API key, tài khoản thanh toán và hạn mức tốc độ bạn dùng cho hơn 1.000 mô hình AI khác trên WaveSpeedAI. Không cần thiết lập nhà cung cấp riêng, không cần SDK cho từng nhà cung cấp, không có hạn mức tốc độ riêng của từng hãng — một lần tích hợp bao quát mọi thứ, từ text-to-image và text-to-video đến tổng hợp âm thanh, tạo 3D, nâng cấp và chỉnh sửa.
Thông số
Khả năng và trạng thái phát hành của Topaz API
Các chi tiết riêng của mô hình mà nhà phát triển tìm kiếm trước khi chọn API: tình trạng khả dụng, độ dài đầu ra dự kiến, hỗ trợ tham chiếu và phương án thay thế đang hoạt động.
Endpoint
Sharpen, Denoise, Restore, Lighting
Bốn endpoint ảnh trong topaz/image/, mỗi endpoint tập trung vào một loại chỉnh sửa, nên pipeline chỉ cần chạy những bước mà ảnh cần.
Đầu vào
JPEG hoặc PNG
Mọi endpoint nhận một ảnh dưới dạng URL hoặc tệp tải lên, không cần viết prompt.
Lựa chọn mô hình
Theo từng endpoint
Tham số model chọn biến thể: kiểu làm nét cho mờ ống kính, mờ chuyển động, lấy nét lại, chân dung và động vật hoang dã; khử nhiễu Normal, Strong hoặc Extreme; chỉnh ánh sáng, cân bằng trắng hoặc tô màu.
Định dạng đầu ra
JPEG, PNG
JPEG là mặc định; đặt output_format là png để có kết quả không mất dữ liệu.
Endpoint
Tất cả endpoint API Topaz
17 endpoint Topaz hiện có sẵn trên WaveSpeedAI — hãy chọn biến thể phù hợp với quy trình của bạn.
Video Deblur
Topaz Video Motion Deblur removes motion blur from fast-moving footage with Topaz Themis. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Hdr
Topaz Video SDR to HDR converts SDR video to 10-bit HDR with Topaz Hyperion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Frame Interpolation
Topaz Video Frame Interpolation raises frame rates and creates smooth slow motion with Topaz Apollo, Chronos and Aion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Denoise
Topaz Video Denoise removes noise and grain from video while keeping natural texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Creative
Topaz Video Upscale Creative creatively upscales AI-generated video with Topaz Astra, inventing new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Generative
Topaz Video Upscale Generative restores and upscales real and AI-generated video with Topaz Starlight diffusion models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale
Topaz Video Upscale upscales and enhances video up to 4K with Topaz's precision Proteus, Artemis, Gaia, Theia, Iris and Dione models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Transparent Upscale
Topaz Transparent Image Upscale upscales transparent PNG images while keeping the alpha channel intact. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Creative
Topaz Image Upscale Creative creatively upscales AI-generated images with Topaz Bloom, adding new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Generative
Topaz Image Upscale Generative upscales and repairs images with Topaz's generative Wonder, Recover and Redefine models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale
Topaz Image Upscale enlarges photos to 2K, 4K or 8K with precise, non-generative Topaz upscaling models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Denoise Generative
Topaz Image Denoise Max removes heavy noise and recovers lost detail with the generative Denoise Max model. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Sharpen Generative
Topaz Image Sharpen Generative rebuilds detail in severely blurred images with generative Super Focus models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112327_sqr1uegu.webp)
Image Sharpen
Topaz Image Sharpen sharpens soft, out-of-focus and motion-blurred photos while keeping them natural. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112312_o76ialis.webp)
Image Restore
Topaz Image Restore cleans dust, scratches and blemishes from scans and old photos. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112304_igpft99n.webp)
Image Lighting
Topaz Image Lighting fixes exposure and white balance, colorizes black-and-white photos and converts to HDR. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112318_eykl2kyy.webp)
Image Denoise
Topaz Image Denoise removes grain and high-ISO noise while preserving detail and texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Ví dụ
Xem Topaz hoạt động
Kết quả thật do API Topaz tạo ra. Rê chuột lên video để xem trước, nhấp để mở trình xem kích thước đầy đủ.
Hướng dẫn
Cách dùng API Topaz
Bốn bước từ đăng ký đến khi có kết quả. Ví dụ đầy đủ bằng Python, Node.js và cURL nằm ở phần API bên dưới.
- 01
Lấy API key
Đăng ký tài khoản WaveSpeedAI và sao chép API key từ bảng điều khiển. Tài khoản mới được tặng credit dùng thử miễn phí — đủ để chạy playground vài chục lần trước khi bắt đầu tính phí.
- 02
Gửi một prediction
POST đầu vào của bạn dưới dạng JSON tới https://api.wavespeed.ai/api/v3/topaz/image/sharpen. Endpoint trả về prediction id ngay lập tức — việc tạo là bất đồng bộ nên bạn không phải giữ kết nối mở trong lúc suy luận.
- 03
Poll để chờ hoàn tất
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Trả về kết quả khi completed; dừng và báo lỗi khi failed, cancelled, timeout hoặc deleted; tiếp tục poll với mọi trạng thái khác.
- 04
Đọc URL kết quả
Khi status là "completed", đọc URL từ data.outputs[0]. URL trỏ tới media bạn đã tạo trên CDN của WaveSpeedAI — ảnh, video, âm thanh hoặc tệp 3D tùy biến thể Topaz bạn đã gọi.
Trường hợp sử dụng
Bạn có thể xây dựng gì với Topaz
Các quy trình phổ biến mà nhà phát triển và người sáng tạo dùng API Topaz cho.
Sửa mờ do ống kính và chuyển động
topaz/image/sharpen khôi phục chi tiết sắc nét cho ảnh mềm hoặc lệch nét, với các biến thể cho mờ ống kính, mờ chuyển động, lấy nét lại và độ nét trông tự nhiên.
Chân dung và động vật hoang dã
Endpoint sharpen có các biến thể được tinh chỉnh cho chân dung và động vật hoang dã, giúp khuôn mặt, lông thú và lông chim có thêm chi tiết mà không bị quầng sáng.
Làm sạch ảnh thiếu sáng và ISO cao
topaz/image/denoise loại bỏ hạt nhiễu và nhiễu ISO cao mà vẫn giữ chi tiết, với các mức Normal, Strong và Extreme cho ảnh xuống cấp từ nhẹ đến nặng.
Phục hồi ảnh cũ và ảnh quét
topaz/image/restore loại bỏ bụi, vết xước và hư hại khỏi ảnh in cổ điển và phim quét, phù hợp cho kho ảnh gia đình và các dự án số hóa.
Chỉnh độ phơi sáng, cân bằng trắng và màu sắc
topaz/image/lighting cân bằng ảnh chụp trong điều kiện ánh sáng kém, chỉnh nhiệt độ màu và có thể thêm màu tự nhiên cho ảnh đen trắng.
Làm sạch hàng loạt cho danh mục và ảnh người dùng tải lên
Cho ảnh đăng bán trên sàn thương mại, ảnh bất động sản hoặc ảnh người dùng gửi đi qua các endpoint cần thiết trong một pipeline tự động, không cần phần mềm máy tính hay chỉnh sửa thủ công.
Mẹo
Mẹo viết prompt cho Topaz
Lời khuyên thực tế để có kết quả tốt hơn từ Topaz — rút ra từ các mẫu hiệu quả trên các mô hình nâng cấp trong các pipeline sản xuất.
- 01
Khử nhiễu trước khi làm nét
Khi ảnh vừa nhiễu vừa mềm, hãy chạy Denoise trước rồi Sharpen sau. Làm nét một ảnh nhiễu sẽ khiến hạt nhiễu rõ hơn cùng với chi tiết.
- 02
Chọn biến thể sharpen phù hợp với kiểu mờ
Dùng biến thể lens blur hoặc refocus cho ảnh lệch nét, biến thể motion blur cho rung máy hoặc chủ thể chuyển động, và biến thể portrait hoặc wildlife khi chủ thể là khuôn mặt hoặc động vật.
- 03
Bắt đầu với mức nhẹ nhất
Hãy thử khử nhiễu Normal trước và chỉ chuyển sang Strong hoặc Extreme khi vẫn còn thấy hạt nhiễu; các mức mạnh hơn sẽ làm mịn kết cấu nhỏ.
- 04
Giữ PNG cho pipeline nhiều bước
Đặt output_format là png khi kết quả được đưa vào bước khác như phóng to hoặc một lần chỉnh sửa thứ hai, để mỗi lượt không cộng thêm nén JPEG.
Giá
Giá API Topaz
Giá tính theo từng kết quả đầu ra. Khoản phí cuối cùng thay đổi theo các tham số bạn đặt trong playground của từng biến thể (độ phân giải, thời lượng, số kết quả, tham chiếu).
| Endpoint | Loại | Giá khởi điểm |
|---|---|---|
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
API
Gọi API Topaz
Đăng ký API key tại wavespeed.ai/accesskey, rồi gửi prediction qua REST. Playground tạo sẵn mã mẫu có thể dán ngay cho mọi tổ hợp đầu vào.
POSThttps://api.wavespeed.ai/api/v3/topaz/image/sharpen
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/topaz/image/sharpen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/topaz/image/sharpen";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/topaz/image/sharpen", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)So sánh
Topaz so với các lựa chọn khác
Khi nào nên chọn Topaz thay vì các mô hình tương tự trên WaveSpeedAI.
Topaz so với Topaz Photo AI (desktop)
Topaz Photo AI là ứng dụng máy tính chạy trên máy của bạn. Các endpoint của Topaz API chạy trên đám mây và được gọi qua REST, phù hợp với máy chủ, tác vụ hàng loạt và ứng dụng xử lý ảnh cho người dùng của chính chúng.
Topaz so với Image Upscaler Collection
Bộ sưu tập Image Upscaler nhằm tăng độ phân giải. Các endpoint Topaz sửa chính bức ảnh: mờ, nhiễu, hư hại và ánh sáng, và thường được chạy trước hoặc cùng với bước phóng to.
Topaz so với Self-hosted open-source models
Các mô hình mã nguồn mở về khử nhiễu và phục hồi cần GPU riêng và công sức bảo trì. Các endpoint Topaz được lưu trữ sẵn, tính giá theo ảnh, và dùng chung một API key cùng tài khoản thanh toán với mọi mô hình khác trên WaveSpeedAI.
Câu hỏi thường gặp
Topaz API — Câu hỏi thường gặp
Giá, giấy phép, tích hợp — những câu hỏi phổ biến về việc chạy Topaz trên WaveSpeedAI.
Những mô hình Topaz nào có trên WaveSpeedAI?
Các endpoint ảnh Topaz gồm Sharpen, Denoise, Restore và Lighting đã hoạt động. Mọi endpoint Topaz đang hoạt động đều được liệt kê trong bảng trên trang này, kèm giá hiện tại.
Tôi có cần prompt không?
Không. Hãy gửi ảnh, chọn một biến thể mô hình nếu muốn khác mặc định, và chọn đầu ra JPEG hoặc PNG.
Các endpoint Topaz được tính giá như thế nào?
Theo từng ảnh, với mức giá hiển thị trên trang của mỗi mô hình và trong bảng giá phía trên. WaveSpeedAI hoạt động theo hình thức pay as you go: không đăng ký thuê bao, và tín dụng không bao giờ hết hạn.
API Topaz là gì?
Topaz là mô hình upscaler của Topaz Labs, được cung cấp dưới dạng REST API trên WaveSpeedAI. Topaz API trên WaveSpeedAI — các mô hình cải thiện ảnh của Topaz Labs dưới dạng endpoint REST: Sharpen cho mờ do ống kính và chuyển động, Denoise cho hạt nhiễu và nhiễu ISO cao, Restore cho bụi và vết xước trên ảnh cũ, và Lighting cho độ phơi sáng, cân bằng trắng và màu sắc. Bạn có thể gọi bằng lập trình hoặc thử từ playground ở liên kết phía trên.
Làm sao để gọi API Topaz?
Đăng ký tài khoản WaveSpeedAI, sao chép API key từ /accesskey, rồi POST tới https://api.wavespeed.ai/api/v3/topaz/image/sharpen với đầu vào dưới dạng JSON. Endpoint trả về prediction id. Hãy poll endpoint kết quả khoảng mỗi 2 giây, tăng khoảng cách với các tác vụ chạy lâu, và dừng ở bất kỳ trạng thái kết thúc nào. Ví dụ Python / Node.js / cURL hướng tới môi trường production ở phía trên.
API Topaz có giá bao nhiêu?
Topaz bắt đầu từ $0.10. Chi phí chính xác thay đổi theo các tham số bạn đặt (độ phân giải, thời lượng, số kết quả, tham chiếu). Phần xem trước chi phí trực tiếp cạnh nút Tạo trong playground hiển thị giá chính xác cho đầu vào hiện tại của bạn.
Có những biến thể Topaz nào?
WaveSpeedAI cung cấp 17 endpoint Topaz đang hoạt động: topaz/video/deblur, topaz/video/hdr, topaz/video/frame-interpolation, topaz/video/denoise, topaz/video/upscale-creative, topaz/video/upscale-generative, topaz/video/upscale, topaz/image/transparent-upscale, và nhiều hơn nữa. Mỗi biến thể có trang playground và giá riêng.
Tôi có thể dùng kết quả của Topaz cho mục đích thương mại không?
Quyền sử dụng thương mại tuân theo giấy phép mô hình của Topaz Labs. Hầu hết mô hình của Topaz Labs cho phép dùng kết quả đầu ra cho mục đích thương mại; hãy xem trang playground của từng mô hình để biết tóm tắt giấy phép cụ thể, và Điều khoản dịch vụ của WaveSpeedAI cho các điều kiện cấp nền tảng.
Tại sao dùng Topaz trên WaveSpeedAI thay vì gọi trực tiếp?
Một API key + một tài khoản thanh toán cho Topaz VÀ hơn 1.000 mô hình AI khác từ các nhà cung cấp khác. Không cần thiết lập SDK cho từng hãng, không có hạn mức tốc độ riêng, không phải viết lại mã tích hợp cho từng hãng. Giá thường ngang bằng hoặc thấp hơn API trực tiếp của Topaz Labs.
Nhà cung cấp
Giới thiệu về Topaz Labs
Đội ngũ đứng sau Topaz và dòng mô hình Topaz Labs rộng hơn trên WaveSpeedAI.
Topaz Labs phát triển phần mềm cải thiện ảnh và video bằng AI được nhiếp ảnh gia, nhà làm phim và studio sử dụng, nổi tiếng với Gigapixel, Photo AI và Video AI. Các mô hình của hãng tập trung khôi phục chi tiết thật: làm nét, khử nhiễu, phục hồi và chỉnh ánh sáng. Trên WaveSpeedAI, các mô hình Topaz có sẵn dưới dạng endpoint REST với một API key và giá pay as you go.
Bắt đầu xây dựng với Topaz trên WaveSpeedAI
Tặng credit dùng thử miễn phí khi đăng ký. Một API key cho hơn 1.000 mô hình AI từ Topaz Labs và mọi nhà cung cấp khác.
/filters:quality(82)/examples/286559ad86f57a6240b138da36b60f72/1783683968956150943_aga01QGv.webp)
/filters:quality(82)/examples/0dce57b9a07f37936a242097f113443c/1783683972641647743_9sbjtCLV.webp)
/filters:quality(82)/examples/9fb30afa73b645f4b1a46f1db1b68526/1783683975803917626_0qGwk9YN.webp)
/filters:quality(82)/examples/4dfc9fa5d4e12a7bb42324519d201d3d/1783683978615057281_fGsBKT3c.webp)