# pAIpe API

> Единый API для работы с нейросетями с оплатой в рублях, управлением доступом, бюджетами и использованием. Интерфейс совместим с OpenAI API.

Базовый адрес API: `https://api.paipe.ru/v1`. Для запросов нужен API-ключ из кабинета. Цены API возвращает в рублях; используйте публичные идентификаторы моделей из `GET /v1/models`.

## Главные материалы

- [Документация для разработчиков](https://paipe.ru/docs): Быстрый старт и справочник возможностей API.
- [Полная документация одним файлом](https://paipe.ru/llms-full.txt): Все руководства ниже в одном Markdown-файле.
- [OpenAPI 3.1](https://paipe.ru/openapi.yaml): Машиночитаемый контракт методов, полей и ошибок.

## Начало работы

- [Chat Completions](https://paipe.ru/docs/ai/chat-completions.md): Текстовые и потоковые ответы, отмена запросов, ошибки и списание.
- [API-ключи](https://paipe.ru/docs/ai/api-key-management.md): Создание, ограничение, замена и отзыв ключей.
- [Проекты и бюджеты](https://paipe.ru/docs/ai/project-management.md): Разделение интеграций и управление месячными бюджетами.
- [Баланс и текущий ключ](https://paipe.ru/docs/ai/credits-and-current-key.md): Доступный баланс, лимиты и сведения о ключе.
- [Использование и журнал](https://paipe.ru/docs/ai/usage.md): Расходы, метаданные запросов и журнал генераций.

## Основные возможности

- [Responses и Embeddings](https://paipe.ru/docs/ai/responses-and-embeddings.md): Ответы, потоковая передача и векторные представления.
- [Функции и JSON](https://paipe.ru/docs/ai/functions-and-structured-outputs.md): Вызов функций, структурированные ответы и reasoning.
- [Пресеты](https://paipe.ru/docs/ai/presets.md): Версионируемые настройки моделей и их безопасное обновление.
- [Кеширование запросов](https://paipe.ru/docs/ai/prompt-caching.md): Повторное использование контекста и стабильность сессий.
- [Веб-поиск](https://paipe.ru/docs/ai/web-search.md): Поиск в интернете с цитатами и отдельным учётом стоимости.
- [Чтение веб-страниц](https://paipe.ru/docs/ai/web-fetch.md): Чтение заранее разрешённых адресов из запроса модели.
- [Rerank](https://paipe.ru/docs/ai/rerank.md): Переранжирование текстовых и мультимодальных документов.

## Файлы и мультимедиа

- [Files API](https://paipe.ru/docs/ai/files.md): Безопасная загрузка, получение и удаление файлов.
- [Изображения во входных данных](https://paipe.ru/docs/ai/multimodal-images.md): Изображения в Chat Completions, Responses и Embeddings.
- [PDF во входных данных](https://paipe.ru/docs/ai/pdf-inputs.md): PDF по ссылке, через Files API или в формате base64.
- [Аудио во входных данных](https://paipe.ru/docs/ai/audio-inputs.md): Анализ аудио через Chat Completions.
- [Видео во входных данных](https://paipe.ru/docs/ai/video-inputs.md): Анализ видео по ссылке или в формате base64.

## Генерация и речь

- [Генерация изображений](https://paipe.ru/docs/ai/image-generation.md): Создание и редактирование изображений, включая потоковые ответы.
- [Стоимость изображений](https://paipe.ru/docs/ai/image-generation-pricing.md): Правила определения цены генерации изображений.
- [Генерация видео](https://paipe.ru/docs/ai/video-generation.md): Создание видео, проверка состояния и получение результата.
- [Распознавание речи](https://paipe.ru/docs/ai/transcriptions.md): Преобразование аудио в текст.
- [Синтез речи](https://paipe.ru/docs/ai/text-to-speech.md): Преобразование текста в аудио.
- [Аудиоответы](https://paipe.ru/docs/ai/audio-outputs.md): Текстовые и звуковые ответы Chat Completions.

## Контроль и аналитика

- [Атрибуция пользователей](https://paipe.ru/docs/ai/end-user-attribution.md): Безопасная привязка расходов к пользователям вашей системы.
- [Analytics Query API](https://paipe.ru/docs/ai/analytics.md): Агрегированные показатели использования и расходов.
- [События наблюдаемости](https://paipe.ru/docs/ai/observability-broadcast.md): Получение обезличенных событий о работе интеграции.
- [Правила обработки содержимого](https://paipe.ru/docs/ai/content-guardrails.md): Блокировка и скрытие чувствительных фрагментов до отправки модели.