ForHosting KIT · 動画ツール

動画の解像度やサイズを変更する方法

Q: 今すぐ使えますか？

まだ使えません。 現在デプロイ中で、公開時期はこのページで追ってお知らせします。

4Kの元動画から、スマートフォンや遅い回線でも再生できる1080pや720pの版を作れます。幅は元の形に合わせて自動で決まります。使った分だけのお支払いで、定額契約は不要です。

近日公開分あたり$0.077

このタスクは現在ご利用いただけないため、購入できません。料金は一切発生しません。

API仕様を見る

ご利用方法ウェブ APIのみAPIメールTelegramアプリ近日

動画リサイズは、動画の解像度や画面サイズを指定した数値に変更する機能です。掲載先の規定サイズに合わせたい、ファイルサイズを抑えたい制作担当者や個人事業主向けの機能です。

動画のサイズ変更で起きること

サイズ変更は画素を単純に引き伸ばす作業ではありません。各フレームを新しい寸法に合わせて作り直し、周囲の元の画素から新しい画素の値を推定したうえで、目標の大きさで改めて書き出します。高さとして1080p、720p、または任意の画素数を指定すると、幅は元の縦横比に合わせて決まるため、映像がつぶれることはありません。縮小すると細部はあえて失われますが、その代わりファイルは小さく軽くなります。一方、拡大しても撮影時に記録されていない細部は生まれないため、本来の高解像度素材より柔らかい印象になります。

使いどころとよくある失敗

同じ動画を複数の場所へ届けるときに役立ちます。速い回線と遅い回線向けに1080pと720pを用意する、スマートフォン向けのSNSに軽い版を出す、古い端末でも再生できるよう講義を720pにする、4Kの原本はそのまま保管しつつ閲覧用の保存版を1080pにする、といった使い方です。受け取った直後、透かしや切り出しの前に縮小しておくと後の作業が速くなります。よくある失敗は、拡大で画質が上がると期待することと、必要になるたびに最大の原本から同じ版を作り直すことです。解像度ごとに一度だけ作っておくのが効率的です。

できること

動画の縦横のピクセル数を指定すると、その解像度に変更した動画を出力します。縦横比を保ったまま、指定した幅や高さに合わせる処理を予定しています。

活用例

掲載先の規定サイズに合わせる

株式会社山田商事は、取引先のポータルサイトが指定する解像度に合わせて、撮影した動画のサイズを変更する予定です。

高解像度動画のファイルサイズ対策

山本翔太さんは、4Kで撮影した動画をそのまま配布するとファイルサイズが大きすぎるため、用途に応じた解像度に落とすことを検討しています。

複数端末向けの動画サイズ調整

合同会社みどりデザインは、スマートフォンとパソコンの両方で表示する動画のサイズを、それぞれの画面に合わせて調整したいと考えています。

よくある質問

縦横比は変わりますか？

指定した幅や高さに合わせて、縦横比を保ったまま変更する処理を予定しています。

解像度を上げることもできますか？

この機能は主に解像度を下げる用途を想定しています。低い解像度の動画を大きく高画質化する場合は、別の処理が必要です。

今すぐ使えますか？

まだ使えません。現在デプロイ中で、公開時期はこのページで追ってお知らせします。

日本語のサポートはありますか？

申し訳ありませんが、日本語でのサポートは行っておりません。サポートは英語またはスペイン語で、担当者が直接対応します。

透かしや切り出しの前と後、どちらでサイズを変えるべきですか？

前に行うのがおすすめです。動画を受け取った直後に縮小しておけば、透かしの追加、見どころの切り出し、GIFへの変換など後の作業がすべて小さなファイルで速く進みます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/video/resize

認証済みのPOSTでタスクを作成し、結果はWebhookまたは署名付きリンクで受け取ります。この機能はAPIで利用でき、対話型のWebツールとしては提供していません。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/video/resize \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video":"https://example.com/clip.mp4"}'

const res = await fetch("https://api.kit.forhosting.com/video/resize", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "video": "https://example.com/clip.mp4"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/resize",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "video": "https://example.com/clip.mp4"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/resize", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"video":"https://example.com/clip.mp4"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"video":"https://example.com/clip.mp4"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/resize", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "video": "https://example.com/clip.mp4"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.resize",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.077

分あたり$0.0045

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_mb`	500
`max_minutes`	60
`max_megapixels`	3.9

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

向いている場面

掲載先のサイトが指定する解像度に合わせたい、高解像度すぎる動画のファイルサイズを抑えたいといった場面に向いています。

提供状況

現在デプロイ中で、実行はまだ受け付けていません。公開後はこのページとAPIの両方から利用できる予定です。

料金と制限

500MB、収録時間60分までの動画に対応する予定です。公開時の料金は1リクエスト$0.077に、動画1分ごと$0.0045です。

技術的な質問

料金はいくらですか

公開時は1リクエスト$0.077に、動画1分ごと$0.0045が加算されます。12分の動画であれば合計は約$0.13です。

対応しているファイルサイズの上限はありますか

500MBまで、収録時間は60分までに対応する予定です。

KITの完全なドキュメントを見る →