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":"定位圖片 photo 中的紅色矩形。"}},"assets":{"reference_photo":{"type":"image","part":"photo_file"}}};type=application/json' \
-F 'photo_file=@image.png;type=image/png'