curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "topaz-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "topaz-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 600,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 28.8,
"user_group": "default"
}
}Topaz
Topaz 動画超解像
- Topaz Video Upscale (topaz-video-upscale) モデルはAI駆動の動画超解像アップスケーリングをサポートしています
- 1x（画質向上のみ）、2x、4xのアップスケールファクターをサポート
- 課金は入力動画の長さ（秒単位）とアップスケールファクターに基づきます
- 非同期処理モード、返されたタスクIDを使用して照会してください
- アップスケールされた動画リンクは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": "topaz-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "topaz-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 600,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 28.8,
"user_group": "default"
}
}承認
##すべてのAPIにBearer Token認証が必要です##
APIキーの取得：
APIキー管理ページにアクセスしてAPIキーを取得してください
リクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY
ボディ
application/json
動画アップスケールモデル名
利用可能なオプション:
topaz-video-upscale 例:
"topaz-video-upscale"
アップスケーリング用の入力動画URLリスト
注意:
- 1リクエストにつき
1動画のみ - 動画URLはサーバーから直接アクセス可能である必要があります（パブリックURLまたは事前署名URL）
- サーバーは課金のために入力動画の長さを自動検出します
- サポートされるフォーマット:
.mp4
Required array length:
1 element例:
["https://example.com/my-video.mp4"]
アップスケール動作を制御するモデル固有のパラメータ
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"
使用された実際のモデル名
例:
"topaz-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