VideoUpscaler API

用 VideoUpscaler API 在你自己的程式裡把影片提升到 1080p、2K 或 4K。只要送出影片 URL、輪詢任務狀態,完成後下載結果即可。API 與網站共用同一套點數,任何程式語言都能透過 HTTPS 呼叫,購買任何點數包後即可開通,產出的影片不帶浮水印。

VideoUpscaler API 使用與 videoupscaler.co 相同的 AI 影片畫質提升引擎,並扣用同一份點數。每個請求都是一般的 HTTPS 呼叫,搭配 JSON 請求本文,任何程式語言都能使用。

Base URL: https://videoupscaler.co/api/v1

僅限付費帳號

API 僅開放給已購買點數或已訂閱的帳號。在價格頁面購買任一點數方案即可開通;免費帳號會收到 403 paid_plan_required。

運作方式

  1. 送出影片:可以是公開的 video_url,也可以是你先上傳的檔案。
  2. 我們讀取影片長度、依此扣除點數,然後開始處理。
  3. 輪詢任務直到狀態變成 completed,再下載 output_url。

快速開始

建立 API 金鑰

使用已購買點數或已訂閱的帳號登入,然後開啟設定 → API 金鑰。建立一把 Key 並複製下來,它只會顯示這一次。Key 的格式類似 vu_live_…。

開始提升畫質

curl https://videoupscaler.co/api/v1/upscale \
  -H "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-video-001" \
  -d '{"video_url": "https://example.com/clip.mp4", "resolution": "4k"}'
const res = await fetch('https://videoupscaler.co/api/v1/upscale', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VIDEOUPSCALER_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'my-video-001',
  },
  body: JSON.stringify({ video_url: 'https://example.com/clip.mp4', resolution: '4k' }),
});
const task = await res.json();
console.log(task.id, task.status);
import os, requests

res = requests.post(
    "https://videoupscaler.co/api/v1/upscale",
    headers={
        "Authorization": f"Bearer {os.environ['VIDEOUPSCALER_API_KEY']}",
        "Idempotency-Key": "my-video-001",
    },
    json={"video_url": "https://example.com/clip.mp4", "resolution": "4k"},
)
task = res.json()
print(task["id"], task["status"])

回應是一個狀態為 processing 的任務。

輪詢直到完成

curl https://videoupscaler.co/api/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VIDEOUPSCALER_API_KEY"

每 5–10 秒輪詢一次,或改用串流接收任務事件。當 status 為 completed 時,從 output_url 下載影片;若為 failed,點數已自動退還,error 會說明失敗原因。

端點

方法路徑用途
POST/upscale扣除點數並開始提升影片畫質
POST/uploads取得用來上傳本機檔案的簽章 URL
GET/tasks/{id}取得單一任務
GET/tasks/{id}/events串流接收狀態變化(Server-Sent Events)
GET/tasks列出你的任務,最新的在前
GET/account點數餘額與價格

想透過 AI 助理操作嗎?把 MCP 伺服器連接到 Claude Code、Cursor 或 VS Code 即可。