ForHosting KIT · 画像の編集・解析

重なり写真からパノラマの横幅を無料で計算

パノラマを合成する前に、完成するキャンバスがどれくらいの幅になるかを知っておくと便利です。この無料計算ツールは、重なり合う各ショットのピクセル寸法と、連続するフレーム間の推定水平重複率を入力として受け取り、結果としてパノラマの横幅、合計重複ピクセル数、そしてすべての画像が高さを指定した場合はパノラマの高さを返します。処理はすべてブラウザ内で完結し、対話的な利用は無料です。同じ計算はAPI経由でも1リクエストあたり$0.002で利用でき、パイプラインに組み込む場合に便利です。

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

無料で実行 API仕様を見る

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

パノラマの横幅はどのように推定されるか

合成パノラマは、連続するフレームが重なり合うため、個々の写真の幅の単純な合計にはなりません。このツールは画像リストを、合成する順番どおりに左から右へ処理します。隣接する各ペアについて、入力された重複率を2つの幅のうち狭いほうに適用し、共有領域を計算します。狭いほうの幅を使うのは控えめで物理的に妥当な選択です。重なり部分は共有する2枚のどちらよりも広くなることはあり得ないからです。この重複ピクセル数は、次のフレームを配置するたびに差し引かれるため、累積の合計は各写真の新しい非重複部分だけが加算されます。結果は推定される最終キャンバス幅（ピクセル）です。計算は単純な積の合計なので、入力した重複率に対しては正確です。不確実さがあるのは、推定した重複率がカメラが実際に撮影したものとどれだけ一致するかだけです。手持ち撮影では20%〜40%の重複が一般的で、三脚のパノラマ雲台を使えば、よりタイトで予測可能な値を計画できます。

入力する内容と得られる結果

入力は合成順に並んだ画像レコードのリストです。各レコードにはピクセル単位の幅が必須で、高さは任意です。overlap_pctはその画像が次の画像と共有する水平方向の重複を、0以上100未満のパーセンテージで表します。最後の画像には次の画像がないため、その重複値は無視されます。出力にはimage_count、推定されるpanorama_width、total_overlap_px（すべての継ぎ目で重複しているピクセル数）、sum_widths_px（重複を無視した場合の素朴な合計）、そしてすべてのレコードが高さを指定した場合のpanorama_heightが含まれます。高さは最大値が採用されます。キャンバスは最も高いフレームに合わせる必要があるからです。100%以上の重複は明確なエラーで拒否されます。完全に重なり合う2フレームは新しい情報を追加せず、通常は入力ミスを示すためです。すべての値は小数点以下6桁に丸められ、実行間で結果が安定し比較可能になります。

より良い合成のための計画のコツ

撮影前、あるいは巨大なキャンバスにディスク容量を割く前に、この推定を活用してください。レンズ、センサーサイズ、ショット間の回転角が分かっていれば、水平画角から重複率を導き出せます。フレーム内で繰り返される割合は、1から画角に対する角度ステップの割合を引いた値に等しくなります。均一なスイープならすべての継ぎ目に同じ率を適用し、途中でステップを変えた場合はペアごとに変えられます。合成ソフトウェアが十分なマッチング特徴を得られるよう、最低15%の重複を確保し、空や水面のような質感の少ないシーンでは30%以上を推奨します。推定幅がエディターやプリンターの対応範囲を大きく超える場合は、フレーム数を減らすか、重複を増やして各フレームの新規領域を減らすか、最終キャンバスの縮小を計画してください。この計算ツールは決定的で即時に結果が出るため、目標サイズに合うまでフレーム数と重複率を自由に試行できます。

活用例

風景パノラマの撮影前計画

スカイラインを5フレームで撮る計画の写真家が、各フレームの幅と想定の30%重複を入力し、外出前に最終キャンバスが大判プリントに十分な幅になるかを確認します。

ギガピクセル作品のキャンバスとストレージの見積もり

数十枚の望遠フレームでギガピクセルのモザイクを制作するスタジオが、合成後の幅を推定し、撮影セッション前にメモリ、スクラッチディスク、合成ソフトウェアのエクスポート上限を確認します。

合成パイプラインの健全性チェック

ドローン写真シーケンスをバッチ処理する開発者が、1リクエストあたり$0.002でAPIを呼び出して出力寸法を予測し、非現実的に狭い、あるいは広い結果になる重複入力のシーケンスにフラグを立てます。

よくある質問

パノラマはすべての画像幅の合計にならないのはなぜですか？

連続するフレームが重なり合うからです。各ペア間の重複部分が差し引かれるため、最終的な幅は幅の合計から各継ぎ目の重複ピクセル数を引いたものになります。

2枚の画像間の重複はどのように計算されますか？

入力された重複率は、隣接する各ペアの2つの幅のうち狭いほうに適用されます。共有領域はどちらの画像よりも広くなれないためです。そのピクセル値は、次のフレームが追加される際に差し引かれます。

100%以上の重複を入力するとどうなりますか？

無効な入力としてリクエストが拒否されます。完全な重複は2枚目の画像が新しい領域を追加しないことを意味し、合成という考え方と矛盾するため、ほとんどの場合はデータ入力ミスを示しています。

画像の順序は結果に影響しますか？

はい。レコードは合成順に左から右へ処理され、各overlap_pctはその画像と次の画像の間の継ぎ目を表します。最後の画像の重複値は無視されます。

パノラマの高さも推定できますか？

はい。すべての画像レコードに高さが含まれている場合、結果にはpanorama_heightが含まれます。キャンバスが最も高いフレームに合うよう、最大の高さが採用されます。いずれかの高さが欠けている場合、そのフィールドは省略されます。

このツールは無料ですか？オンラインで動作しますか？

対話的な利用はすべてブラウザ内で無料で動作し、何もアップロードされません。同じ計算は、スクリプト化されたパイプライン向けに、1リクエストあたり$0.002でAPI経由でも提供されています。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/image/stitch-panorama-estimate

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

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

curl -X POST https://api.kit.forhosting.com/image/stitch-panorama-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images":[{"width":4000,"height":3000,"overlap_pct":30},{"width":4000,"height":3000,"overlap_pct":25},{"width":4000,"height":3000}]}'

const res = await fetch("https://api.kit.forhosting.com/image/stitch-panorama-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "images": [
      {
        "width": 4000,
        "height": 3000,
        "overlap_pct": 30
      },
      {
        "width": 4000,
        "height": 3000,
        "overlap_pct": 25
      },
      {
        "width": 4000,
        "height": 3000
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/stitch-panorama-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "images": [
        {
            "width": 4000,
            "height": 3000,
            "overlap_pct": 30
        },
        {
            "width": 4000,
            "height": 3000,
            "overlap_pct": 25
        },
        {
            "width": 4000,
            "height": 3000
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/stitch-panorama-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"images":[{"width":4000,"height":3000,"overlap_pct":30},{"width":4000,"height":3000,"overlap_pct":25},{"width":4000,"height":3000}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"images":[{"width":4000,"height":3000,"overlap_pct":30},{"width":4000,"height":3000,"overlap_pct":25},{"width":4000,"height":3000}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/stitch-panorama-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "images": [
    {
      "width": 4000,
      "height": 3000,
      "overlap_pct": 30
    },
    {
      "width": 4000,
      "height": 3000,
      "overlap_pct": 25
    },
    {
      "width": 4000,
      "height": 3000
    }
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 200

エラー

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

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