curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tencent-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "tencent-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 120,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 3.264,
"user_group": "default"
}
}Tencent
Tencent 動画超解像
- Tencent Video Upscale (tencent-video-upscale) は既存の動画の画質を向上させ、
720p、1080p、2k、4kに拡大します - 実写、アニメーション、遠景の小さな顔、顔の忠実な再現、細部の強調、柔らかな仕上がりに対応する 7 種類のスタイルを提供します
- デフォルトでは元の動画のフレームレートを維持します（
model_params.max_fps: "source"）。"30"、"60"、"120"で上限を設定できます。フレームレートを下げる処理のみ行い、フレーム補間は行いません - 動画の長さに応じて課金されます。解像度と出力フレームレートごとの料金は EvoLink のモデル料金をご確認ください
- 非同期処理です。返されたタスク ID を使用してタスクの状態を確認してください
- 送信後のタスクはキャンセルできません
- 処理後の動画 URL の有効期間は 24 時間です。お早めに保存してください
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tencent-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "tencent-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 120,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 3.264,
"user_group": "default"
}
}承認
##すべてのAPIにBearer Token認証が必要です##
APIキーの取得：
APIキー管理ページにアクセスしてAPIキーを取得してください
リクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY
ボディ
application/json
動画超解像モデルの名前
利用可能なオプション:
tencent-video-upscale 例:
"tencent-video-upscale"
入力動画 URL のリスト
注意：
- 1 回のリクエストで対応する動画は
1本のみです（複数指定した場合は最初の動画のみ使用します） - 動画 URL はサーバーから直接アクセスできる必要があります（公開 URL または署名付き URL）
- 対応形式：
.mp4、.mov - 最大動画長：
60秒 - 元の動画の解像度は最大 4K です（短辺が
2160ピクセル以下） - 送信時にサーバーが動画の長さ、解像度、フレームレートを読み取ります。読み取りに失敗した場合は
video_probe_failedを返します
Required array length:
1 element例:
["https://example.com/my-video.mp4"]
動画の内容に合わせて選択する高画質化スタイル
選択肢：
realistic- 汎用実写：実写などの一般的な映像 — デフォルトrealistic_distant- 実写・遠景：遠景に写る小さな顔に最適化animation- 汎用アニメーション：アニメやカートゥーンなどanimation_distant- アニメーション・遠景：遠くのキャラクターが多い映像の小さな顔に最適化face_fidelity- 顔の忠実な再現：元の顔の特徴をできるだけ維持detail_boost- 細部の強調：質感や輪郭をより鮮明にsoft- ソフト：シャープ化を抑え、より自然な仕上がりに
大文字と小文字は区別しません。無効な値は拒否されます
利用可能なオプション:
realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft 例:
"realistic"
動画の短辺を基準とする出力解像度
選択肢：
720p- 短辺720ピクセル1080p- 短辺1080ピクセル — デフォルト2k- 短辺1440ピクセル4k- 短辺2160ピクセル
注意：
- 元の動画より低い解像度は指定できません。例えば、
1080pの動画では1080p、2k、4kを選択でき、720pは拒否されます - 元の解像度以上の最も低い設定を選ぶと、画像サイズはほぼ変わりません
利用可能なオプション:
720p, 1080p, 2k, 4k 例:
"1080p"
モデル固有のパラメータ
Show child attributes
Show child attributes
タスク完了後の 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"
レスポンス
動画の高画質化タスクが正常に作成されました
タスク作成タイムスタンプ
例:
1757169743
タスク ID
例:
"task-unified-1757169743-7cvnl5zw"
使用された実際のモデル名
例:
"tencent-video-upscale"
タスクタイプ
利用可能なオプション:
video.generation.task タスク進捗率（0-100）
必須範囲:
0 <= x <= 100例:
0
タスクステータス
利用可能なオプション:
pending, processing, completed, failed 例:
"pending"
動画タスクの詳細情報
Show child attributes
Show child attributes
タスク出力タイプ
利用可能なオプション:
text, image, audio, video 例:
"video"
使用量と課金情報
Show child attributes
Show child attributes