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

Chat Completions

Создавайте многоходовые диалоги в привычном формате messages и выбирайте модель на каждый запрос.

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

Сообщения и роль

Массив messages передаёт контекст как последовательность сообщений. System задаёт правила задачи, user добавляет запрос, assistant и tool возвращают историю выполнения.

Не строите историю путём склеивания строк: сохраняйте роль и исходный порядок каждого сообщения.

Chat completion
bash
curl --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "messages": [
      {"role": "system", "content": "Be concise and cite assumptions."},
      {"role": "user", "content": "Draft a release checklist."}
    ],
    "temperature": 0.2
  }'

Управление выводом

  • model определяет семейство и вариант модели.
  • temperature, top_p и ограничение вывода задают вариативность и размер ответа.
  • Передавайте только параметры, которые указаны как поддерживаемые для выбранной модели.

Надёжный цикл

Отделяйте сетевой сбой от корректного ответа модели с finish_reason. Отказ модели или ограничение контекста — данные для интерфейса, а не повод подменять результат.

Сохраняйте исходный request body и нормализованный ответ без ключей, когда это допустимо правилами хранения ваших данных.

Дальше