# Jev が画像入力と新しい Box 型に実験対応

専用ヘッダーを付けると、state・指示・基準に画像を埋め込めるようになった。画像内の位置を返すBox型はJev 1.14でのみ使える。

- 正規URL: https://jevguide.jp/news/typesafe-images-and-box-type-2026-10-14/
- 公開: 2026-10-14T22:09:09.133Z
- 更新: 2026-10-14T22:09:09.133Z
- 検証区分: 一次情報で確認

## 要点

- 画像はリクエスト最上位の assets に一度だけ登録し、そのキーを state、質問の instructions、criteria のどこかに書くと、その位置に画像が入る。Jev 1.13 と 1.14 の両方が対応し、TypeSafe-Danger-Zone-Images ヘッダーが必要
- Box は、画像の中で対象がある位置を上下左右の4辺（幅・高さに対する0〜1の割合）と confidence で返す新しい質問タイプ。criteria は取らず、jev-preview か jev-1.14.0 を指定する
- 受け付けるのは PNG と JPEG の静止画で、1枚16MiB、リクエスト本体32MiBまで。範囲外の画像は縮小されずに拒否され、1枚でも拒否されるとリクエスト全体が失敗する

## 何が変わるか

写真やスクリーンショットを文章に書き起こさず、そのまま判定に使えるようになった。ただし公式は画像と Box を本番向けの水準にはまだ達していない実験機能と位置づけ、形式・上限・精度はリリースごとに変わりうると明記している。同じ画像を複数の質問で使うなら、各質問に埋め込まず state に1回置いてパスで参照すると、トークンもサイズ上限も節約できるとドキュメントにある。試作や検証に使い、本番の判定に組み込むのは様子を見てからにしたい。

## 関連ガイド

- [Jev の3つの質問タイプ（Choice / Score / Noul）の書き方と選び方](/guides/question-types/)
- [Jev の state の設計: 文字列・オブジェクト・配列の使い分け](/guides/designing-state/)
- [Jev の REST API の使い方とエラーコード](/guides/rest-api/)

## 出典

- [Images - TypeSafe Docs](https://docs.typesafe.ai/images)
- [Box - TypeSafe Docs](https://docs.typesafe.ai/primitives/box)

---
typesafe.ai とは無関係の非公式ガイドです。
