Video 提供： Topaz

Topaz Video Upscale API

プロ品質のビデオアップスケールとフレーム補間。

Topaz Video Upscale を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。

APIキーを取得 Apiframe Studioで使う Topaz Video Upscale APIドキュメントを見る

model: "topaz-video-upscale"

Topaz Video Upscale の特長

720p / 1080p / 4k で出力。
画像からの動画生成と参照画像に対応。
高速処理 — 1回の生成あたり平均約300秒。
Topaz のアカウント不要の従量課金。成功した生成分だけお支払いいただきます。
Apiframe のすべてのモデルで、1つのAPIキー・統一請求・冪等性・Webhookに対応。

Topaz Video Upscale で作成

Apiframeの Topaz Video Upscale API で生成した出力例です。

サンプル準備中

概要

エンドポイント: POST /v2/videos/upscale
モデルID: topaz-video-upscale
パラメータキー: topazVideoParams
モダリティ: 動画
プロバイダー: Topaz
平均完了時間: ~300s

機能

解像度720p, 1080p, 4k

画像入力対応

平均時間~300秒

クイックスタート

APIキーを添えて POST /v2/videos/upscale に1回リクエストを送るだけで Topaz Video Upscale による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。

curl -X POST https://api.apiframe.ai/v2/videos/upscale \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "topaz-video-upscale",
        "topazVideoParams": {
            "video": "https://example.com/input.jpg",
            "target_resolution": "1080p",
            "target_fps": "30",
            "enhance_model": "auto"
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/upscale",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "model": "topaz-video-upscale",
        "topazVideoParams": {
            "video": "https://example.com/input.jpg",
            "target_resolution": "1080p",
            "target_fps": "30",
            "enhance_model": "auto"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/videos/upscale", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "topaz-video-upscale",
    "topazVideoParams": {
      "video": "https://example.com/input.jpg",
      "target_resolution": "1080p",
      "target_fps": "30",
      "enhance_model": "auto"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

レスポンスとジョブのライフサイクル

生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする（または webhook_url を指定する）と、result フィールドに出力URLが格納されます。

1. 送信レスポンス (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 結果をポーリング

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

入力スキーマ

Topaz Video Upscale エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。

パラメータ	型	必須	デフォルト	許可値 / 範囲	説明
model	string	必須	"topaz-video-upscale"	"topaz-video-upscale"	このエンドポイントのモデル識別子。
topazVideoParams.video	string (URL)	任意	—	—	mp4 / mov / webm.
topazVideoParams.target_resolution	string	任意	"1080p"	"720p", "1080p", "4k"	Target resolution
topazVideoParams.target_fps	string	任意	"30"	"24", "30", "60"	Target fps
topazVideoParams.enhance_model	string	任意	"auto"	"auto", "theia-fine-tune-detail", "theia-fine-tune-fidelity", "apollo", "rhea", "iris"	Enhance model
topazVideoParams.subject_detection	string	任意	"all"	"all", "foreground", "background", "none"	Subject detection

よくある質問

Topaz Video Upscale APIに関するよくある質問をまとめました。

Topaz Video Upscale の API はありますか？

はい。Apiframe は単一の REST エンドポイント（`POST /v2/videos/upscale`、`model: "topaz-video-upscale"`）で Topaz Video Upscale を提供します。対応するすべてのモデルで、統一されたAPI・キー・請求をご利用いただけ、Topaz の個別アカウントは不要です。

Topaz Video Upscale API の料金はいくらですか？

Topaz Video Upscale は Apiframe のシンプルな従量課金制で、成功した生成分のみお支払いいただきます。プランと数量割引は料金ページをご覧ください。

Topaz Video Upscale API はどのように呼び出しますか？

`X-API-Key` と、`model: "topaz-video-upscale"` を含む JSON ボディを添えて `/v2/videos/upscale` に POST リクエストを送ります。レスポンスで返る `jobId` を `GET /v2/jobs/{id}` でポーリングするか、Webhook で結果を受け取ります。

Topaz Video Upscale はどんなパラメータに対応していますか？

Topaz Video Upscale は、共通の `prompt`・`webhook_url` に加えて、`topazVideoParams` の下にネストされた 5 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。

解決しませんでしたか？

サポートに問い合わせる Discordに参加