AI API モデル廃止・移行期限カレンダー（OpenAI / Anthropic / Google ほか）

Claude API のプロンプトキャッシュ機能を使うと、繰り返し送る部分の読み取りコストを通常入力の約1/10に削減できる。実装は cache_control フラグを付けるだけだが、モデルごとの最小トークン数未満は無視される、プレフィックスの1バイト変更でキャッシュ全滅、tools 変更で先頭から無効化される、の3つのハマりどころがある。usage.cache_read_input_tokens で実測確認必須。

グラフRAG検証シリーズの一環として、Azure Document Intelligenceを用いたAI-OCR連携を実装し、35件の書類をOCRにかけた結果、平均類似度0.9990という高精度を達成した。ただしデジタルネイティブPDF（テキスト埋め込み済み）であるにもかかわらず、アルファベットの「O」を丸記号「〇」と誤読するなど、視覚的な誤認識が発生する現象を発見した。

GitHub Copilot CLI 上で Gemini 3.7 Flash と Sonnet 5 をコスト・品質・実行時間で比較した結果、Gemini 3.7 Flash × high は Sonnet 5 × xhigh より約 28% 安いが、実行時間は 1.8 倍遅い。両モデルが生成するコードの品質欠陥パターンも異なることが判明。

エージェント実行中にtools配列を変更するとプロンプトキャッシュが無効になり、数万トークンが再課金される問題がある。Anthropicが導入した「mid-conversation tool changes」機能を使うと、tools配列を固定のまま、tool_addition/tool_removalブロックで途中から特定ツールの表示/非表示を制御でき、キャッシュを温存できる。