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 и сбором технических данных для улучшения работы сайта согласно политике конфиденциальности.