API比重計算ツール

API比重計算ツールは、石油液体の比重を業界標準の厳密な比重計の式でAPI度に変換します。原油や精製製品の比重（60/60 °F基準で測定された相対密度）を入力すると、対応するAPI度に加えて、軽質・中質・重質・超重質の分類、計算式の文字列、および実験ノートや貨物レポートに貼り付けられる代入手順が返されます。比重がゼロ以下はこのスケールでは物理的に意味を持たないため、ソルバーは数値をでっち上げるのではなく、明確なinvalid_inputエラーで拒否します。

API比重とは何か、計算式の仕組み

米国石油協会（American Petroleum Institute）が定義し、ASTM D287で標準化されたもので、基準温度60 °Fにおいて石油液体が水と比べてどれだけ重いか軽いかを表します。比重との関係は厳密で代数的です。ここでいう比重とは60/60 °F基準の相対密度、つまり基準温度での液体の密度を同じく基準温度での水の密度で割った値であり、単位のない純粋な無次元数です。適用するのは閉形式の定義のみで、温度による体積補正係数、ブレンドルール、表の補間は一切行いません。したがって得られる答えは、システム間での再現性のために小数点以下12桁に丸められた、手計算で求めるのと同じ純粋な定義値です。API比重は、石油業界が実際に使う密度スケールです。API度は141.5を比重で割り、131.5を引いた値です。比重がちょうど1の水はちょうど10 °APIに対応し、10が境界線になります。10 °APIより大きい液体は水に浮き、それより小さい液体は沈みます。ウェスト・テキサス・インターミディエイトのような軽質原油は40 °API前後、中質グレードは20〜33 °APIあたりに集まり、重質原油は10〜22の間、超重質ビチューメンは10未満に下がります。この式は比重で割るため、比重がゼロではスケールは定義されず、負では物理的に意味を持ちません。この計算ツールは、無限大や不条理な結果を返すのではなく、該当フィールド名を示したinvalid_inputエラーで両方を拒否します。

APIの呼び出し方とレスポンスの読み方

値は有限の数値、または通貨記号や桁区切りを含まない厳密な数値文字列で、絶対値が1兆以内、かつゼロより大きい必要があります。必須フィールドが1つ、specific_gravityを含むJSONボディを送信してください。このフィールドはsg、value、gravity、relative_density、densityというエイリアスでも受け付けるため、既存のペイロードをリネームせずに統合できます。成功時のレスポンスは丸められたspecific_gravityをエコーし、次にapiとapi_gravity（便宜上2つのキーで同じAPI度の値）、API度記号のunit、一般的な業界区分に従ったlight、medium、heavy、extra heavyのclassification、使用した厳密な定数を示すformula文字列、結果を要約する平易な英語のmessage、入力から分類までの代入行を順に並べたsteps配列を返します。検証エラー（フィールド欠落、非有限値、上限超過、比重ゼロ以下）は、問題のフィールド名を示すメッセージ付きでinvalid_inputを返し、失敗したタスクがプリペイド残高から課金されることはありません。料金は成功リクエスト1件あたり定額の$0.002で、単位アイテムはunit、限界単価はゼロです。このため、ダッシュボード、モバイルアプリ、バッチアッセイ処理、あるいは相対密度の読み値を保持し、表示やチケット、SI・ヤードポンド混在レポートのためにAPI度が必要なあらゆるクライアントに安全に組み込めます。

実用上のヒント、制限、およびこの計算ツールを使う場面

比重1はちょうど10 °APIを返し、0.85前後の軽質原油は約35 °API、0.93近辺の重質原油は約20 °APIを返します。逆方向の変換や、キログラム毎立方メートル、グラム毎立方センチメートル、ポンド毎ガロンなどの絶対密度単位への換算が必要な場合は、専用のAPI比重変換ケイパビリティをご利用ください。この計算ツールは意図的に比重からAPI度への変換のみを決定論的に行います。このツールは定義式のみを適用することにご注意ください。このランディングは、API比重計算ツール、比重からAPI度、石油比重計の式の確認を探す方々のためのものです。失敗した呼び出しはinvalid_inputを返し残高を消費しないため、統合中の探索的なスクリプトやクライアント側の検証プローブを安価に行えます。