Topaz 動画超解像

承認

Authorization

string

header

必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

デフォルト:topaz-video-upscale

必須

動画アップスケールモデル名

利用可能なオプション:

topaz-video-upscale

例:

"topaz-video-upscale"

video_urls

string<uri>[]

必須

アップスケーリング用の入力動画URLリスト

注意:

1リクエストにつき 1 動画のみ
動画URLはサーバーから直接アクセス可能である必要があります（パブリックURLまたは事前署名URL）
サーバーは課金のために入力動画の長さを自動検出します
サポートされるフォーマット: .mp4

Required array length: 1 element

例:

["https://example.com/my-video.mp4"]

model_params

object

アップスケール動作を制御するモデル固有のパラメータ

Show child attributes

callback_url

string<uri>

タスク完了後の HTTPS コールバックアドレス

コールバックタイミング：

タスクが完了、失敗、またはキャンセルされた時にトリガーされます
課金確認完了後に送信されます

セキュリティ制限：

HTTPS プロトコルのみサポート
内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など）
URL の長さは 2048 文字以内

コールバックメカニズム：

タイムアウト：10 秒
失敗時最大 3 回リトライ（1 秒/2 秒/4 秒後にリトライ）
コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします

例:

"https://your-domain.com/webhooks/video-task-completed"

レスポンス

動画アップスケールタスクが正常に作成されました

created

integer

タスク作成タイムスタンプ

例:

1757169743

string

タスク ID

例:

"task-unified-1757169743-7cvnl5zw"

model

string

使用された実際のモデル名

例:

"topaz-video-upscale"

object

enum<string>

タスクタイプ

利用可能なオプション:

video.generation.task

progress

integer

タスク進捗率（0-100）

必須範囲: 0 <= x <= 100

例:

0

status

enum<string>

タスクステータス

利用可能なオプション:

pending,

processing,

completed,

failed

例:

"pending"

task_info

object

動画タスクの詳細情報

Show child attributes

type

enum<string>

タスク出力タイプ

利用可能なオプション:

text,

image,

audio,

video

例:

"video"

usage

object

使用量と課金情報

Show child attributes