Как работают решения

Запрос состоит из трёх частей:

Поле Назначение
model Модель, которая оценивает запрос. В настоящее время поддерживается только gpt-6-luna.
input Общие данные для вопросов: строка текста или сообщения пользователя с текстом и изображениями.
questions Что нужно оценить, включая тип вопроса, инструкции и допустимые варианты или уровни оценок.

Ответ содержит массив answers. Присвойте каждому вопросу уникальное name для идентификации его ответа; API повторит это имя в ответе.

Выберите тип вопроса

Тип Для чего использовать Основной результат
predicate Проверить условие, такое как видимые повреждения или релевантность отрывка. probability: оценка от 0 до 1, что условие верно.
choice Выбрать один вариант, такой как отдел или категория контента. choice: одно из предоставленных значений.
score Оценить входные данные по упорядоченным уровням, таким как серьёзность проблемы. score: взвешенное по вероятности среднее значение индексов уровней.

Оба типа choice и score возвращают вероятности по дискретным вариантам. Используйте choice для категорий без порядка, таких как отделы. Используйте score для упорядоченных уровней, таких как серьёзность; он принимает взвешенное по вероятности среднее значение числовых индексов, чтобы произвести оценку, которая может находиться между уровнями.

Используйте Decisions, когда вашему приложению требуется один из этих типов ответов. Используйте Structured Outputs с Responses API, когда вам нужно сгенерировать объект, который следует вашей собственной JSON-схеме, например извлеченные поля или письменное объяснение, или вызов функций, когда вам нужно, чтобы модель запросила вызов инструмента с аргументами.

Проверить изображение на видимые повреждения

Используйте вопрос типа predicate для проверки фотографии товара на видимые повреждения. Этот запрос объединяет изображение с инструкциями искать трещину, разрыв или вмятину.

Есть ли на этом предмете вмятина?

Гладкая чашка для путешествий цвета шалфея Синяя туристическая кружка с заметной вмятиной

Первое изображение — кружка без повреждений (вероятность вмятины: 0,01). Второе изображение — кружка с выраженной вмятиной (вероятность вмятины: 0,96).

Запрос:

curl https://api.openai.com/v1/decisions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "input": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://it-herald.ru/storage/news/49984025/97e8721c15124e389c505b39e4df2126.webp"
        }
      }
    ],
    "questions": [
      {
        "type": "predicate",
        "name": "has_dent",
        "instructions": "Is there a dent, dip, or depression in the surface?"
      }
    ]
  }'

Ответ:

{
  "id": "dcision_1234567890",
  "object": "decision",
  "created": 1234567890,
  "answers": [
    {
      "name": "has_dent",
      "type": "predicate",
      "probability": 0.01
    }
  ]
}