圖片與多模態資產
向決策模型傳送圖片:官方 SDK 的 Image 資產(multipart)或純 JSON 內嵌 base64 兩種形態、單檔 50MB 上限、TypeSafe-Danger-Zone-Images 標頭自動補發、各模型視覺能力差異。
傳入圖片的兩種方式
官方 SDK(multipart,推薦)
把 SDK 的 Image 資產放進 assets,並在 state/instructions/criteria 裡引用它。SDK 會把請求編碼為 multipart/form-data;EasyJev 翻譯為上游可接受的內嵌形態轉發,位元組完整送達——媒體絕不入庫。
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。