图片与多模态资产
向决策模型发送图片:官方 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。