provod.ai / docs
API

System One API

Нативный формат TypeSafe: текст, JSON, изображения и типизированные ответы.

Обновлено

System One использует нативный JSON-формат TypeSafe для тех же моделей Decisions и тот же API-ключ. Цена берётся из каталога выбранной модели.

Текст и JSON

Используйте decision.json из примера Decisions API, заменив путь запроса:

Terminal
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 настоящими байтами изображения.

Image request body
{
  "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. В кабинете можно попробовать модель без написания кода через выбор модели в чате.

Решение проблем

На этой странице