cicora.ai
Русский
Спецификация APIБыстрый старт

Быстрый старт

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

OpenAI-style SDK и curlhttps://cicora.ai/api/v1
Messages SDK и Claude Codehttps://cicora.ai/api

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

1. Подготовьте окружение

Храните ключ только в переменной окружения или секрет-хранилище. Клиентский код не должен содержать ключ и не должен отправлять его в логи.

Базовый URL для интеграции — https://cicora.ai/api/v1. Во всех примерах ниже маршрут добавляется к этой базе.

Первый запрос
bash
export CICORA_API_KEY=replace_with_your_key

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": "user", "content": "Explain this API in one sentence."}]
  }'

2. Соберите запрос

  • Укажите точный идентификатор модели из каталога.
  • Передайте сообщения в порядке диалога: system, user, assistant и tool при необходимости.
  • Начните с низкой вариативности, затем подберите параметры под задачу.

3. Обработайте ответ

Извлеките текст из первого доступного элемента ответа и сохраните id запроса рядом со своим trace-id.

Проверяйте статус и структуру ошибки до повторной отправки. Повторять безопасно только операции, для которых ваше приложение может исключить дублирование.

Дальше