System One API
Нативный формат TypeSafe: текст, JSON, изображения и типизированные ответы.
Обновлено
System One использует нативный JSON-формат TypeSafe для тех же моделей Decisions и тот же API-ключ. Цена берётся из каталога выбранной модели.
Текст и JSON
Используйте decision.json из примера Decisions API, заменив путь запроса:
export PROVOD_API_KEY="sk_..."
curl --fail-with-body --silent --show-error https://api.provod.ai/v1/systemone \
-H "Authorization: Bearer $PROVOD_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @decision.jsonАльтернативный путь POST /api/v1/systemone выполняет ту же операцию. Не добавляйте /v1 дважды при настройке base URL.
Отличия от Decisions API
instructionsв вопросе может быть пропущено или равноnull.- Choice возвращает
choice,confidenceиprobabilities. - Score возвращает
score,confidence,probabilitiesиlegend. - Noul возвращает
noul, число от 0 до 1. - Box возвращает
boxс границамиtop,bottom,left,rightот 0 до 1 иconfidence.
Максимум для Choice: 255 вариантов, для Score: 10 уровней; конкретная модель может иметь меньшие ограничения. Доступные типы вопросов и контекст указаны в каталоге.
Изображения и Box
Эта возможность доступна только для моделей с поддержкой изображений и Box в System One. Добавьте заголовок typesafe-danger-zone-images: true. Передавайте PNG/JPEG в assets, поле data_base64 содержит только Base64 без префикса data:. Multipart-загрузка не поддерживается.
Структура тела ниже иллюстративная: замените BASE64_IMAGE_BYTES настоящими байтами изображения.
{
"model": "typesafe/jev-1.14",
"state": "Product photo: product",
"assets": {
"product": {"type": "image", "format": "png", "data_base64": "BASE64_IMAGE_BYTES"}
},
"questions": {
"product_region": {"type": "box", "instructions": "The product in the product photo."}
}
}Границы Box отсчитываются от левого верхнего угла изображения. Box сам по себе не доказывает, что объект найден; добавьте вопрос Noul о наличии объекта, если это важно для вашей задачи.
Расширенный контекст
Если модель поддерживает расширенный контекст, явно включите его заголовком typesafe-danger-zone-long-context: true. Значение этих заголовков должно быть ровно true; если режим не нужен, не передавайте заголовок. Включение режима не отменяет лимиты модели и размер тела запроса.
Стоимость, учёт токенов и правила повторов описаны в Decisions API. В кабинете можно попробовать модель без написания кода через выбор модели в чате.