# 画像APIの透明背景と編集マスクを検証するには？ > 実ピクセルをデコードしてalpha分布、境界、寸法、位置合わせを検査し、制御テストでマスク規則を確認します。PNGという拡張子だけでは透明性を証明できません。 HTTP 200と `.png` は、背景が正しく透明である証拠ではありません。出力をデコードし、マスクの意味をモデルごとに試します。 ## 実際のカラーモードをデコードする | 検査 | 要確認の状態 | |---|---| | Alpha channel | 要求したのに存在しない | | 最小alpha | 全部不透明 | | 透明画素 | ほぼゼロ、または被写体内 | | 寸法 | 契約外 | | シグネチャ | コンテナ不一致 | | Decode | 破損・切断 | ## 透明度の分布を測る 透明、半透明、不透明の画素数と連結領域を数え、小さな穴や切れた影を検出します。 ## 対照的な背景へ合成する 白、黒、中間グレー、彩度の高い色に合成し、白フリンジ、黒いmatte、漏れを目視します。 ## API呼び出し前にマスク形状を検証する ```text assert source.width == mask.width assert source.height == mask.height assert orientation_is_normalized(source, mask) ``` ## エンドポイントのマスク規則を確認する | テスト | 分かること | |---|---| | 左半分を白 | 白が編集か保持か | | 小さな角だけ白 | 反転や回転 | | 灰色ランプ | soft mask対応 | | 空マスク | no-op規則 | | 全面マスク | 最大編集範囲 | ## 硬い境界と柔らかい境界を試す 二値境界とグラデーション境界を別々に試し、ぼかし、閾値、色にじみを確認します。 ## 編集出力を要求と照合する 編集領域外の変化、透明画素のRGB、寸法、色空間、被写体欠損を検査します。 ## モデル能力の証拠を更新する モデル、バージョン、日付、テスト入力、期待値、結果を保存し、仕様変更時に再実行します。 [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=validate-transparent-backgrounds-edit-masks-image-api) を使う場合も、ルートごとのalphaとmask規則を記録してください。 ## 結論 ピクセルをデコードし、alpha分布、対照背景、寸法、非対称マスク、境界を検査してからアセットを受け入れます。 ## FAQ ### PNGなら必ず透明ですか？ いいえ。alpha channelがない、または全ピクセルが不透明な場合があります。 ### 背景が実用的に透明かどうかは？ alpha分布を測り、明暗の背景へ合成して縁を確認します。 ### 白は編集領域ですか？ APIごとに異なるため、非対称の制御マスクで確認します。 ### sourceとmaskの寸法が違う場合は？ 明示された変換規則がなければ拒否します。 ### 柔らかい境界はどう試しますか？ 灰色のランプを使い、featheringか二値化かを観察します。 ### Atlas Cloudは役立ちますか？ モデルを統合できますが、ピクセルとマスク規則の検証はアプリ側で行います。