画像とマルチモーダル資産
意思決定モデルに画像を送る:公式 SDK の Image アセット(multipart)または JSON インライン base64 の 2 形態、ファイルあたり 50MB 上限、TypeSafe-Danger-Zone-Images ヘッダーの自動付与、モデルごとの視覚対応の違い。
画像を添付する 2 つの方法
公式 SDK(multipart、推奨)
SDK の Image アセットを assets に渡し、state/instructions/criteria 内で参照します。SDK はリクエストを multipart/form-data でエンコードし、EasyJev が上流が受け付けるインライン形式に変換してバイトをそのまま配送します——メディアが DB に入ることはありません。
from typesafe_sdk import Image, Noul photo = Image("product.png") result = client.system_one( state=f"Product photo: {photo}", questions={"damaged": Noul(instructions="Is the product damaged?")}, model="typesafe/jev-latest", # use a vision-capable model assets={"photo": photo}, )
純 JSON(インライン base64)
SDK を使わない場合、アセットを JSON 本体の assets に直接置きます:{"key": {"type": "image", "format": "png", "data_base64": "..."}}。参照方法は同じで、両形態とも同一の制限を共有します。
{
"model": "typesafe/jev-latest",
"state": {"photo": "<image:photo>"},
"questions": {
"damaged": {"type": "noul", "instructions": "Is the product damaged?"}
},
"assets": {
"photo": {"type": "image", "format": "png", "data_base64": "iVBORw0KGgo..."}
}
}制限とセマンティクス
| 項目 | ルール |
|---|---|
| メディアファイルあたり | 上限 50 MB(multipart はパート バイト数、JSON はデコード後サイズ)。超過時は 413 media_too_large。 |
| リクエスト本体の合計 | multipart 既定 60 MB / 純 JSON 既定 70 MB(50 MB メディアの base64 展開を収めるため)。 |
| 課金 | 画像は通常の入力 token として課金——メディア追加料金なし。レート制限の推定からメディア バイトは除外。 |
| opt-in ヘッダー | アセットを含むリクエストには公式要件の TypeSafe-Danger-Zone-Images: true ヘッダーを自動付与——手動設定は不要です。 |
| プライバシー | メディア バイトは保存されません:インライン本体はアーカイブ前に base64 を <media:N bytes> プレースホルダーに置換、multipart は JSON パートのみアーカイブ(約 64 KB で切り捨て)。 |
NOTE
視覚対応はモデルにより異なります。実測では Jev 系は画像を受理し(最小辺 約 512 px、参照は長文テキスト内に埋め込み可)、非 Jev プロバイダの一部はトップレベル state 項の文字列参照のみ受理します。非対応の組み合わせは上流の 4xx がそのまま返り、課金されません。画像を送る場合は typesafe/jev-latest など視覚対応モデルを選んでください。