Skip to content
EASYJEV

圖片與多模態資產

向決策模型傳送圖片:官方 SDK 的 Image 資產(multipart)或純 JSON 內嵌 base64 兩種形態、單檔 50MB 上限、TypeSafe-Danger-Zone-Images 標頭自動補發、各模型視覺能力差異。

傳入圖片的兩種方式

官方 SDK(multipart,推薦)

把 SDK 的 Image 資產放進 assets,並在 state/instructions/criteria 裡引用它。SDK 會把請求編碼為 multipart/form-data;EasyJev 翻譯為上游可接受的內嵌形態轉發,位元組完整送達——媒體絕不入庫。

Python · typesafe-sdk · Image
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": "..."}},引用方式相同。兩種形態共用同一套限額。

JSON · POST /v1/systemone
{
  "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。