Jev 参数与接口差异
了解 Jev 系列模型在结构化决策接口下的能力差异与使用方式。
根据所选型号调整问题类型、图片与上下文配置。完整请求、响应及在线调试参阅 TypeSafe Decisions。
适用模型与接口
| 模型 | 支持的接口 |
|---|---|
| jev-1.14.0新 jev-1.13.0 | TypeSafe Decisions：/v1/decisions、/v1/systemone |
问题类型差异
| 配置 | 型号差异与用法 |
|---|---|
noul/choice/score | 两款均支持，可在一个请求中混合使用 |
box | 需要 Jev 1.14；Jev 1.13 使用前三种问题类型 |
state/instructions/criteria | 两款均支持文本和图片；图片使用 assets 引用，可放入问题指令与判断标准 |
| 工具选择 | 使用 choice 返回应用应执行的动作名称，后续工具由应用调用 |
图片输入与 Box
图片与 Box 属于官方实验能力，请求需携带 TypeSafe-Danger-Zone-Images: true。
| 配置 | 使用要点 |
|---|---|
| 图片格式 | 两款支持 PNG/JPEG，不直接输入音频或视频；视频可先提取静态帧 |
| 图片提交 | 可使用 JSON Base64 或 Multipart；资源声明、引用和尺寸规则见接口 Reference |
box 坐标 | 左上角为原点；横向边乘图片宽度、纵向边乘图片高度，即得到像素位置 |
box.confidence | 可能为 null，不应强制解析为数字，也不能将空值当作 0 |
| 目标不存在 | Box 仍会返回坐标。搭配 Noul 判断是否存在目标，再决定是否使用坐标 |
| 多个目标 | 一个 Box 问题定位一个目标；定位不同目标时使用不同问题，并在指令中明确区分 |
上下文配置
| 配置 | 使用要点 |
|---|---|
| 默认上下文 | 两款均为单请求 64K、单问题 32K；单请求计算 state 与全部问题，单问题计算 state 与一个问题 |
| 长上下文 | 添加 TypeSafe-Danger-Zone-Long-Context: true 后，两项限制均为 262K；按请求开启，普通请求省略 |
| 问题数量 | 没有独立的固定数量上限，但整份请求须同时满足单请求和单问题上下文限制 |
| 用量 | 图片与文本均计入输入 Token；输出 Token 免费。平台价格查看 模型广场 |
调用示例
将 MODEL_ID 替换为平台提供的完整模型 ID。图片定位使用 Jev 1.14，并将 image.png 替换为符合尺寸要求的本地图片。
curl 'https://api.agtcloud.ai/v1/decisions' \
-H 'Authorization: Bearer your-api-key' \
-H 'TypeSafe-Danger-Zone-Images: true' \
-F 'request={"model":"MODEL_ID","state":{"photo":"reference_photo"},"questions":{"target":{"type":"box","instructions":"Locate the red rectangle in photo."}},"assets":{"reference_photo":{"type":"image","part":"photo_file"}}};type=application/json' \
-F 'photo_file=@image.png;type=image/png'