Jev のパラメータと API の違い
構造化決定 API における Jev モデルの機能の違いと使い方を確認します。
選択したモデルに合わせて質問タイプ、画像、コンテキストを設定します。完全なリクエスト、レスポンス、オンラインデバッグは TypeSafe Decisions を参照してください。
対象モデルとエンドポイント
| モデル | 対応エンドポイント |
|---|---|
| jev-1.14.0新着 jev-1.13.0 | TypeSafe Decisions: /v1/decisions, /v1/systemone |
質問タイプの違い
| 設定 | モデルの違いと使い方 |
|---|---|
noul/choice/score | 両モデルが対応し、1 回のリクエストで混在できます |
box | Jev 1.14 が必要です。Jev 1.13 では最初の 3 種類を使用します |
state/instructions/criteria | 両モデルともテキストと画像に対応します。画像は assets で参照し、質問指示や判定基準にも含められます |
| ツール選択 | choice でアプリケーションが実行すべき操作名を返し、後続のツール呼び出しはアプリケーションが行います |
画像入力と Box
画像と Box は公式の実験的機能です。リクエストに TypeSafe-Danger-Zone-Images: true を付けてください。
| 設定 | ポイント |
|---|---|
| 画像形式 | 両モデルは PNG/JPEG に対応し、音声や動画の直接入力には対応しません。動画は静止フレームを抽出して使用できます |
| 画像の送信 | JSON Base64 または Multipart を使用できます。リソース宣言、参照、サイズのルールは API Reference を参照してください |
box の座標 | 左上が原点です。横方向の辺に画像幅、縦方向の辺に画像高さを掛けるとピクセル位置になります |
box.confidence | null の場合があります。数値を必須にしたり、空値を 0 として扱ったりしないでください |
| 対象が存在しない場合 | Box は座標を返します。Noul で対象の存在を確認し、座標を使うか判断してください |
| 複数の対象 | 1 つの Box 質問は 1 つの対象を特定します。対象ごとに別の質問を使い、指示で明確に区別してください |
コンテキスト設定
| 設定 | ポイント |
|---|---|
| 既定のコンテキスト | 両モデルとも 1 リクエスト 64K、1 質問 32K です。リクエストでは state と全質問、質問では state と 1 つの質問を数えます |
| 長いコンテキスト | 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'