Подключите ИИ-облако A5X

[ REFERENCE ]

Справочник API

Полные спецификации: параметры, ошибки и вебхуки

Подключаете клиентов из своей CRM или SaaS? Смотрите Integration API — там партнёрский ключ int_live_… и создание аккаунтов.

[ WALKTHROUGH ]

Подключение за 7 шагов

Аккаунт → ключ `sk_live_…` → проверка баланса → первый ИИ-запрос → саммари и контроль качества. Копируйте примеры и подставляйте свой ключ вместо `YOUR_API_KEY`.

[ ШАГ 01 ]

Что вы подключаете

A5X — облако с ИИ-продуктами и одним клиентским ключом. Зарегистрировались, взяли ключ sk_live_… — и вызываете REST из своей системы.

• Speech — расшифровка звонков и встреч (аудио/видео).
• Vision — видеопотоки с камер, CV-события и webhooks.
• LLM — чат, эмбеддинги и RAG (совместимо с OpenAI API).
• Public API — коммуникации по каналам, баланс и ссылки в кабинет (тот же ключ).
• MCP — Cursor, Claude и другие агенты: https://mcp.a5x.pro/mcp, тот же sk_live_….
• Коннекторы АТС в кабинете загружают записи в Speech — альтернатива Speech API или ручной загрузке.

[ ШАГ 02 ]

Создайте аккаунт

Зарегистрируйтесь через быстрый старт — это ваш личный кабинет на платформе. На баланс сразу приходит 1 000 ₽ для первых запросов.

Регистрация занимает пару минут. После входа вы окажетесь в кабинете app.a5x.pro.

[ ШАГ 03 ]

Возьмите API-ключ

В кабинете откройте Настройки → API-ключ и создайте (или перевыпустите) ключ. Он выглядит как sk_live_… и показывается один раз — сразу сохраните его в секретное хранилище.

Во всех REST-запросах и в MCP передавайте Authorization: Bearer sk_live_…. Без ключа REST ответит 401 invalid_api_key; MCP — 401 unauthorized. При паузе кабинета запись через REST обычно 403 client_inactive; чтение через MCP при этом доступно.

[ ШАГ 04 ]

Проверьте, что ключ работает

Самый простой запрос — узнать баланс. В ответе также is_active и allow_credit: по ним видно, на паузе ли клиент и разрешён ли кредит при минусе.

curl "https://s2t.a5x.pro/api/public/v1/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "balance_rub": "100.00",
  "is_active": true,
  "allow_credit": false
}

401 — проверьте ключ и заголовок Authorization. is_active: false — пауза (пополните баланс). При allow_credit: true минус сам по себе не отключает сервис.

[ ШАГ 05 ]

Сделайте первый запрос

Выберите продукт под вашу задачу и скопируйте пример. Подставьте свой sk_live_… вместо YOUR_API_KEY, выполните в терминале — и откройте полную спецификацию, когда понадобятся параметры.

curl -X POST "https://s2t.a5x.pro/api/v1/audio/transcriptions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileUrl":"https://example.com/call.mp3","language":"ru"}'

[ ШАГ 06 ]

Саммари

Для Speech добавьте summary=true при создании транскрибации — платформа построит AI-конспект. Задача уйдёт в async: дождитесь webhook summary.completed или опросите статус по task_id.

curl -X POST "https://s2t.a5x.pro/api/v1/audio/transcriptions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://example.com/call.mp3",
    "language": "ru",
    "diarize": true,
    "summary": true,
    "speakers": [
      { "id": "emp_01", "name": "Иван", "role": "sales" },
      { "id": "c_99", "name": "Клиент", "role": "client" }
    ]
  }'

curl "https://s2t.a5x.pro/api/public/v1/communications?request_record_id=YOUR_RECORD_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "transcription_status": "success",
  "summary_generation_status": "success",
  "summary_text": "Клиент уточнил условия и договорился о следующем звонке."
}

Если передали speakers, summary включается автоматически. Готовый текст — в summary_text / user_summary (Public API); Speech task отдаёт только статус ASR.

[ ШАГ 07 ]

Контроль качества

После расшифровки и саммари платформа может оценить звонок по сценарию QC из кабинета (приветствие, следующий шаг и т.д.). Результат приходит в webhook qc.completed и в поле qc_evaluation коммуникации.

curl "https://s2t.a5x.pro/api/public/v1/communications?id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "summary_generation_status": "success",
  "qc_generation_status": "success",
  "qc_evaluation": {
    "scenario_code": "sales_inbound",
    "score_pct": 75,
    "comment": "Оператор поприветствовал клиента и зафиксировал следующий шаг.",
    "criteria": [
      {
        "code": "greeting",
        "value_type": "binary",
        "value": true,
        "evidence": "Добрый день, A5X Cloud, меня зовут Андрей."
      }
    ]
  }
}

Сценарии и критерии настраиваются в кабинете. Коды критериев и шаблоны сценариев — в справочнике Public API.