ForHosting KIT · 動画ツール

動画のアスペクト比が各プラットフォームに合うか確認

動画は技術的に有効でも、掲載先の画面に適さない場合があります。この確認ツールは、入力された幅と高さの比率を、指定したソーシャルプラットフォームの掲載枠と比較します。形が一致するか、素材が細いため左右に余白が生じるか、素材が広いため左右が切り抜かれるかを返します。動画のアップロードやデコードは行いません。比率、プラットフォーム、掲載枠を入力するだけで、企画、検品、自動投稿フローに利用できる一貫した結果を得られます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

素材を判定する前に掲載先をお選びください

アスペクト比の適合条件はプラットフォーム名だけでなく、掲載枠ごとに決まります。通常の YouTube 動画は横長ですが、YouTube Shorts は縦長です。Instagram にも縦長フィード、正方形フィード、Reels、Stories という別々の枠があります。素材を実際に掲載する組み合わせを選び、表示時の比率を 16:9、9:16、4:5、1:1 のような幅:高さの形式で入力してください。一般的でない形式には小数も使用できます。本ツールはプラットフォーム名と掲載枠名を小文字にそろえ、登録済みの対象枠を参照して数値比率を比較します。ファイル名、解像度、回転タグ、エンコード済みストリームは調べません。スマートフォン動画に向きのメタデータがある場合は、回転適用後の寸法から実際に表示される比率を求めてください。未対応の組み合わせは明示的にエラーとなるため、フィードの条件を Story に誤用したり、別のプラットフォームの条件を流用したりすることを防げます。

一致、余白、切り抜きの結果をご確認ください

一致という結果は、わずかな浮動小数点許容差の範囲で、素材と掲載先が数学的に同じ形であることを示します。形状の調整は不要です。余白という結果は、素材が掲載枠より細いことを示します。全体を残して対象枠へ収めると左右に未使用部分が生じます。一般には pillarboxing と呼ばれますが、API では依頼された総称である letterboxed を返します。切り抜きという結果は、素材が掲載枠より広いことを示します。高さ全体を使って枠を埋めるには、左右の内容を削る必要があります。これらは中央配置による幾何学的な判定であり、各サービスのアップロード画面が必ず同じ処理を行うという保証ではありません。手動の再配置、ぼかし背景、複数比率への対応などが提供される場合もあります。切り抜きの場合は端にある人物、字幕、ロゴをご確認ください。余白の場合は、単色の帯ではなく設計した背景を使うかご判断ください。

公開や変換の前に検査へ組み込めます

掲載先が決まった時点で確認し、最終レンダリング、アップロード、映像レビューに時間をかける前に問題を見つけてください。コンテンツ管理システムでは、予定するプラットフォームと掲載枠を素材と一緒に保存し、信頼できるメタデータから表示比率を計算して、本機能を検証工程として呼び出せます。一致した素材は自動的に次へ進められます。余白または切り抜きの結果では、レビュー作業を作成したり、用意済みの別素材を選んだり、専用の切り抜き計算へ送ったりできます。判断に用いた対象値が編集者にも分かるよう、required_ratio を監査記録に残してください。応答には正規化済みのプラットフォーム、掲載枠、入力比率も含まれるため、同じ素材を複数の配信先へ送るログを読みやすくできます。本機能は画素の変更、安全領域の計算、圧縮予測、アップロード拒否の判定は行いません。API による一回の確定的な確認は $0.002 で、動画自体は転送されません。

活用例

予約投稿の前に素材を検査できます

投稿キューが指定枠へ動画を送る前に、不適合な形式へ確認フラグを付けられます。

適切なマスター素材を選べます

素材と掲載先を比較し、横長、正方形、縦長の各バージョンへ処理を振り分けられます。

編集レビューの規則を作成できます

切り抜きでは端の内容を確認し、余白では背景やレイアウトを検討する工程へ送れます。

よくある質問

一致という結果は何を表しますか？

入力した比率の数値的な形が、指定したプラットフォームと掲載枠に登録された条件と同じであることを表します。

なぜ余白が必要と表示されますか？

素材が対象枠より細いためです。全体を残すと、左右に帯または別の背景処理が必要になります。

この場合の切り抜きとは何ですか？

素材が掲載先より広いため、中央で枠を満たすと左側と右側の一部が削られることを意味します。

動画はアップロードまたは編集されますか？

いいえ。比率だけを比較し、映像の受信、デコード、保存、サイズ変更、切り抜き、変換は行いません。

API での確認料金はいくらですか？

API の各リクエストは $0.002 です。動画を転送しないため、映像処理に応じた追加料金はありません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/video/video-aspect-platform-check

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

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

curl -X POST https://api.kit.forhosting.com/video/video-aspect-platform-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ratio":"16:9","platform":"youtube","placement":"video"}'

const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ratio": "16:9",
    "platform": "youtube",
    "placement": "video"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/video-aspect-platform-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ratio": "16:9",
    "platform": "youtube",
    "placement": "video"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "ratio": "16:9",
  "platform": "youtube",
  "placement": "video"
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

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

エラー

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

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