Jev: различия параметров и API
Возможности и особенности использования моделей Jev с API структурированных решений.
Выбирайте типы вопросов, изображения и параметры контекста с учетом модели. Полные запросы, ответы и онлайн-отладку смотрите в 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; объявления ресурсов, ссылки и размеры описаны в API 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'