cicora.ai
Русский
Спецификация APIResponses API

Responses API

Используйте единый объект input, когда приложению удобнее работать с выходными элементами и действиями в одной модели данных.

Справочник интеграции: выбирайте параметры и доступные возможности из API-настроек аккаунта и каталога модели для своего окружения.

Создание ответа

Responses-запрос передаёт model и input. Input может быть короткой строкой или структурированным набором элементов, если это требуется сценарием.

Проектируйте обработчик вокруг массива output: текст, вызов инструмента и служебные элементы могут иметь разные типы.

Responses API request
bash
curl --request POST https://cicora.ai/api/v1/responses \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "input": "Summarize the incident report for an engineer."
  }'

Контроль сценария

  • Сохраняйте id ответа и связанный conversation/session id в своей системе.
  • Ограничивайте число автоматических шагов в агентском цикле на стороне приложения.
  • Проверяйте параметры модели до добавления аудио, изображений или инструментов.

Разбор результата

Не полагайтесь на позицию единственного текстового элемента. Итерируйте output, извлекайте известные типы и сохраняйте неизвестные для наблюдаемости.

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

Дальше