ForHosting KIT · 画像の編集・解析

画像の幅と高さからアスペクト比を計算

この画像アスペクト比計算ツールは、ピクセル単位の幅と高さを、同じ形を表す最小の整数比へ変換します。1920 と 1080 を入力すると、16:9 と、その比を構成する個別の数値が返されます。レスポンシブレイアウトの準備、書き出し結果の確認、メディア要件の文書化、解像度が異なる同形画像の比較にご利用いただけます。処理は決定的で、ネットワークサービスを使用しません。幅または高さがゼロの画像には定義可能な比率がないため、ゼロ値はエラーとして扱います。

● Beta無料・ブラウザ内で実行
ご利用方法 ウェブAPIメールTelegramアプリ 近日

画像の寸法を正確に入力してください

画像の幅と高さを、整数のピクセル数で入力してください。通常は、OS のファイル情報画面、画像編集ソフトの文書プロパティ、デジタルアセット管理システム、またはアップロード処理が返すメタデータで確認できます。元画像の向きをそのまま反映することが重要です。横向き画像が幅 1920 ピクセル、高さ 1080 ピクセルなら、縦向きに回転した画像は幅 1080 ピクセル、高さ 1920 ピクセルになります。両者は異なる形状なので、結果もそれぞれ 16:9 と 9:16 になります。ピクセル寸法は分数ではなく、個別の列と行を表すため、正の安全な整数のみを受け付けます。数値欄には単位、乗算記号、カンマ、説明文を追加しないでください。幅と高さは、どちらもゼロより大きい必要があります。いずれかがゼロの場合、寸法が欠けた画像には幾何学的な比率を定義できないため、無効な入力としてエラーを返します。

比率を簡約する仕組みをご確認ください

この計算では、ユークリッドの互除法によって二つの寸法の最大公約数を求めます。次に、幅と高さを同じ最大公約数で割り、画像の形を保ったまま、最小の正の整数の組へ簡約します。1920 × 1080 の画像では最大公約数が 120 なので、両方を 120 で割ると 16 と 9 になります。結果は 16:9 と表示され、自動処理向けに ratio_width と ratio_height の個別フィールドでも返されます。一般的な形式の一覧表は参照しないため、標準的な動画サイズだけでなく、珍しい寸法も同じ方法で正確に処理できます。たとえば 1500 × 1000 は 3:2、1024 × 1024 は 1:1 になります。二つの寸法に 1 より大きい共通の約数がなければ、元の組がすでに最簡比です。レスポンスには元の幅と高さも含まれるため、どの入力値から比率が得られたかをアプリケーション側で明確に記録できます。

デザインや自動処理に結果をご活用ください

簡約した比率を使うと、解像度に左右されず画像の形を比較できます。320 × 180 のサムネイル、1280 × 720 のプレビュー、3840 × 2160 のマスター画像は、ピクセル数や保存容量が大きく異なっても、すべて 16:9 になります。レスポンシブ CSS では、返された値を aspect-ratio 宣言に使用したり、画像の読み込み前に適切な領域を確保するプレースホルダーに利用したりできます。編集システムでは、特定の解像度を強制せず、アップロード画像が指定の形状を満たすか検証できます。制作フローでは、文字列を解析するより構造化比較が適する場合は二つの数値を保存し、読みやすい表示が必要な場合は aspect_ratio をご利用ください。同じ比率でも、画質、ファイルサイズ、切り抜き、カラープロファイル、向きのメタデータが同じとは限りません。この機能が示すのは幅と高さの数学的関係だけです。ブラウザーでは無料で、API の自動リクエストは 1 件あたり $0.002 からご利用いただけます。

画像の書き出しをご確認ください

公開前に、書き出したピクセル寸法が意図した形状を維持しているか確認できます。

レスポンシブな領域を作成できます

画像の読み込み完了前に適切な空間を確保するため、簡約した比率を取得できます。

メディアのアップロードを検証できます

固定解像度を要求せず、サイズが異なるファイルの正規化済み比率を比較できます。

1920 × 1080 はどの比率になりますか?

両方の寸法を 120 で割れるため、16:9 に簡約されます。

幅または高さがゼロの場合はどうなりますか?

ゼロの寸法では画像比率を定義できないため、無効な入力エラーを返します。

小数の寸法を使用できますか?

いいえ。画像寸法には、安全な整数で表せる正のピクセル数をご入力ください。

画像のサイズ変更や切り抜きも行いますか?

いいえ。入力された幅と高さの簡約された関係だけを計算します。

API の料金はいくらですか?

API リクエストは 1 件あたり $0.002 からです。ブラウザー版は無料でご利用いただけます。

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

POSThttps://api.kit.forhosting.com/image/aspect-ratio-calc

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

curl -X POST https://api.kit.forhosting.com/image/aspect-ratio-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080}'
{
  "width": 1920,
  "height": 1080
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.aspect_ratio_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

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