ForHosting KIT · 画像の編集・解析

写真の露出差を段数で計算｜2つの設定を比較

この写真露出差計算ツールは、絞り、シャッター時間、ISOから成る2組の撮影設定を比較します。3要素の変化を符号付きの段数に換算するため、2組目が1組目より明るい露出か暗い露出かを確認できます。正の値は2組目の露出が多いこと、負の値は少ないこと、ゼロは両者が同等であることを示します。絞り、シャッター、ISOそれぞれの寄与も個別に表示されるため、結果を検算できます。欠損値、有限でない値、ゼロ、負の値は計算前にエラーとなります。

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

無料で実行 API仕様を見る

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

2つの露出を比較する仕組み

写真の露出は、連動する3つの設定で決まります。シャッター時間はセンサーに光が届く長さを、ISOは記録上の感度を、絞りはF値の二乗を通じて光量を調整します。本ツールでは各組み合わせを、ISOとシャッター秒数の積を絞り値の二乗で割った相対露出として表します。次に2組目を1組目で割り、その比率の2を底とする対数を求め、符号付きの段数を算出します。プラス1段なら2組目の相対露出は2倍、マイナス1段なら半分です。これは撮影設定同士の比較であり、写真が適正露出かどうかを判定するものではありません。被写体の明るさ、フィルター、フラッシュ、測光、表現意図は入力に含まれないためです。比率と対数を物理的に意味のある値にするため、6項目はすべて有限かつゼロより大きい数でなければなりません。

符号付き結果と内訳の読み方

主結果のstops_differenceは、1組目を基準にした2組目の差を示します。正なら2組目が明るく、負なら暗く、ゼロなら同等です。exposure_ratioは同じ比較を倍率で表します。さらにaperture_stops、shutter_stops、iso_stopsが個別に返され、3つの符号付き寄与の合計が総段数になります。F値を小さくして絞りを開くと正、絞ると負の寄与です。シャッター時間を長くすると正、短くすると負になります。ISOを上げると正、下げると負です。複数の設定を同時に変えた場合でも、絞りによる減少をシャッターやISOがどれだけ補ったか確認できます。設定が整数段に一致しなければ、小数の結果が出るのは正常です。有用な端数を残しつつ浮動小数点の微小な誤差を整えるため、繰り返し実行してもブラウザーとAPIで安定したJSONが得られます。

撮影計画と確認での実用的な使い方

未知の設定を求めるのではなく、完成した2組の露出設定を直接比べたい場合にご利用ください。手持ち撮影と三脚撮影の比較、2件のメタデータ間の露出変化の測定、絞り変更をシャッターとISOで完全に補正できたかの確認に役立ちます。シャッター時間は秒で入力します。たとえば125分の1秒は0.008です。絞りにはレンズのF値、ISOには感度の数値を指定してください。順序には意味があり、1組目と2組目を入れ替えると絶対値は同じまま符号が反転します。露出が同等でも、被写体ぶれ、被写界深度、ノイズが同じになるとは限りません。計算は決定論的で、ネットワーク、保存領域、乱数、現在時刻を使用しません。そのため、授業、制作現場の確認、自動テスト、メタデータ解析に適しています。正常なAPIリクエストは$0.002で、同じ計算をブラウザーでは無料で利用できます。

活用例

2つのカメラ設定を比較

絞り、シャッター時間、ISOを同時に変更した後の露出差を符号付きで測定します。

写真メタデータを検証

2組のEXIF値を段数差と各設定の検証可能な寄与に変換します。

露出三角形の課題を採点

2組目が開始設定と同等か、より明るいか、より暗いかを確認します。

よくある質問

正の段数差は何を意味しますか？

2組目の相対露出が1組目より多いことを示します。プラス1段は2倍です。

負の結果は何を示しますか？

2組目の相対露出が少ないことを示します。マイナス1段は1組目の半分です。

異なる設定でもゼロ段になりますか？

はい。絞り、シャッター、ISOが相殺すれば同等になりますが、被写界深度、動き、ノイズは変わり得ます。

シャッター速度はどのように入力しますか？

秒単位の正の数で入力してください。たとえば125分の1秒は0.008です。

ゼロや負の値が拒否されるのはなぜですか？

F値、時間、ISOは厳密に正でなければ、有効な比率と対数を計算できないためです。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/image/exposure-stops-calc

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

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

curl -X POST https://api.kit.forhosting.com/image/exposure-stops-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"aperture_1":4,"shutter_1":0.008,"iso_1":100,"aperture_2":5.6,"shutter_2":0.016,"iso_2":200}'

const res = await fetch("https://api.kit.forhosting.com/image/exposure-stops-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "aperture_1": 4,
    "shutter_1": 0.008,
    "iso_1": 100,
    "aperture_2": 5.6,
    "shutter_2": 0.016,
    "iso_2": 200
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/exposure-stops-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "aperture_1": 4,
    "shutter_1": 0.008,
    "iso_1": 100,
    "aperture_2": 5.6,
    "shutter_2": 0.016,
    "iso_2": 200
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/exposure-stops-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"aperture_1":4,"shutter_1":0.008,"iso_1":100,"aperture_2":5.6,"shutter_2":0.016,"iso_2":200}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"aperture_1":4,"shutter_1":0.008,"iso_1":100,"aperture_2":5.6,"shutter_2":0.016,"iso_2":200}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/exposure-stops-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "aperture_1": 4,
  "shutter_1": 0.008,
  "iso_1": 100,
  "aperture_2": 5.6,
  "shutter_2": 0.016,
  "iso_2": 200
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

`max_mb`	15
`max_megapixels`	12

エラー

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

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