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。