API: Мои ИИ-Ассистенты

Вы можете использовать API PR‑CY для подключения к различным AI‑инструментам (чат‑боты, помощники, тематические ИИ, например ИИ‑психолог).

Процесс работы с AI‑инструментом

Получить API‑ключ — зарегистрируйтесь и возьмите ключ в Настройки API.
Создать задачу через POST — указать нужный AI‑инструмент (aiToolId), версию, список сообщений и параметры генерации.
В ответ будет ID задачи в едином формате.
Получить результат по ID задачи через GET‑запрос.

1. Создание запроса

POST:

https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/

Пример запроса (curl)

curl 'https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Api-Key: ваш_api_ключ' \
  --data-raw '{
    "data": {
      "type": "toolTasks",
      "attributes": {
        "toolName": "aiTools",
        "params": {
          "aiToolId": 240,
          "aiToolVersion": "1.0.0",
          "messages": [
            {"role": "user", "text": "привет, давай поговорим"}
          ],
          "model": "gpt-4o-mini",
          "temperature": 0.5,
          "maxTokens": 4000,
          "maxContext": 500
        }
      }
    }
  }'

Описание параметров `params`:

Параметр	Тип	Обязательный	Описание
`aiToolId`	int	✅	Идентификатор AI‑инструмента (например, 240 — ИИ‑психолог)
`aiToolVersion`	string	✅	Версия AI‑инструмента (например `"1.0.0"`)
`messages`	array	✅	Массив сообщений: `[{"role":"user","text":"..."}]`. Поддерживаются `user`, `assistant`, `system`.
`model`	string	✅	Модель для генерации ответа (например — `"gpt-4o-mini"`)
`temperature`	float	❌	Креативность (0 — максимально детерминировано, выше 1 — более креативно).
`maxTokens`	int	❌	Лимит токенов в ответе.
`maxContext`	int	❌	Лимит учитываемых сообщений из истории.

2. Ответ при создании задачи

API вернёт ID задачи:

{
  "data": {
    "type": "toolTasks",
    "id": "2a67cb477beceb3a677bcf1592214e24",
    "attributes": {..}
  }
}

3. Получение результата

GET:

https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/{task_id}?include=tests

Пример запроса:

curl 'https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/2a67cb477beceb3a677bcf1592214e24?include=tests' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Api-Key: ваш_api_ключ'

Не нашли нужной информации? Напишите нам в тех.поддержку

🍪 Используя сайт, вы соглашаетесь с обработкой cookie и сбором технических данных для улучшения работы сайта согласно политике конфиденциальности.