Перейти к основному содержимому

Документация API

Unlimited API

Получите доступ к поддерживаемым AI-моделям по подписке поставщика. Сведения о доступных моделях, ценах и технических условиях собраны в одном месте.

Аутентификация и области доступа

Передавайте клиентский API-ключ по HTTPS в заголовке Authorization: Bearer. Не указывайте ключи в URL. Для инференса Unlimited требуется область ai:inference; для маршрутов смет, заданий, их состояния и артефактов обучения — ai:training. Действуют ограничения частоты запросов. Ключ доступа к модели-ориентиру дополнительно ограничен моделью, для которой выдано разрешение.

Управление API-ключами в панели

  • POST /api/v1/chat/completions Authorization: Bearer ai:inference

Открыть документацию

Запросы на генерацию диалога

Этот адрес API, совместимый с OpenAI, принимает JSON-запрос POST и возвращает результат диалога. Содержимое сообщения должно быть строкой; допустимые роли: system, user и assistant.

Переданный идентификатор модели и сообщения направляются в текущий настроенный AI-шлюз по умолчанию. Это не обещает прямое подключение к конкретному поставщику и не требует фиксированного SDK.

POST https://fusionpointai.com/api/v1/chat/completions · ai:inference

Используйте точный идентификатор модели поставщика из каталога Unlimited API. Идентификаторы и доступность берутся из каталога и могут меняться; идентификатор в примере является заполнителем, а не действующим ID модели.

Тело запроса

Только пример запроса. Замените все значения в угловых скобках своими данными. Числовые ID модели-ориентира, плана и счёта в примерах — заполнители, а не существующие записи.

{
    "model": "<MODEL_ID_FROM_UNLIMITED_CATALOGUE>",
    "messages": [
        {
            "role": "user",
            "content": "<YOUR_PROMPT>"
        }
    ],
    "temperature": 0.2,
    "max_tokens": 512
}

Ответы и ошибки

Успешный ответ содержит id, object, created, model, а также поля choices и usage поставщика. Для неверного тела запроса возвращается HTTP 400 с error.message, error.type, error.code и сведениями об ошибках полей. При сбое поставщика возвращается HTTP 500 с provider_error. Возможны также ошибки аутентификации, области доступа и ограничения частоты запросов.

Распространённые ошибки

  • 400 invalid_request_error Отсутствует обязательное поле или значение не соответствует допустимому формату либо диапазону.
  • 401 Ключ Bearer отсутствует, недействителен, отозван или ограничен.
  • 403 У ключа нет ai:inference либо ключ модели-ориентира используется для другой модели.
  • 429 Достигнут лимит запросов; подождите перед повторной попыткой.
  • 500 provider_error Поставщик инференса не вернул результат.

Коммерческий доступ, а не обучение модели

Подписка открывает доступ к моделям, включённым в план поставщика. Запрос инференса не обучает модель и не передаёт её веса. Месячные и годовые суммы указаны в действующих коммерческих записях.

Интеграция через API и SDK

Используйте документированный адрес API для инференса FusionPointAI, ключ API клиента и доступный идентификатор модели. SDK формирует и отправляет запросы, но не обязательно запускает у себя модель поставщика. Поддерживаемые форматы запросов и способы аутентификации описаны в справочнике API.

Технические ограничения сохраняются

Коммерческий доступ без ограничения количества запросов не отменяет ограничения контекстного окна и объёма ответа, особенности модальностей конкретной модели, защитные механизмы сервиса и применимые правила поставщика. Перед проектированием нагрузки проверьте условия выбранной модели и сервиса.

Доступность и планы для действующих клиентов

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

Безопасность и операционные меры

Используйте API-ключи с ограниченными правами, храните секреты на сервере и соблюдайте документированные правила работы с учётными записями, смены ключей и управления доступом. До использования в рабочей среде согласуйте требования конкретной нагрузки к обработке данных и поддержке.

От подписки к интеграции

Сравните подходящие планы, ознакомьтесь с условиями, оформите подписку через существующий процесс работы с учётной записью, получите учётные данные API и проверьте запросы по документации API.

Корпоративные сценарии

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

FAQ

Обучает ли Unlimited API модель для меня?

Нет. Сервис предоставляет доступ к инференсу поддерживаемых моделей. Если вам нужна отдельная обученная пользовательская модель, выберите Model Training API.

Разрабатывает ли FusionPointAI модели поставщиков?

Нет. Исходный разработчик указан на странице сервиса поставщика. FusionPointAI обеспечивает интеграцию платформы, коммерческий доступ, управление учётными записями, выставление счетов, документацию и поддержку.

Можно ли использовать любую модель из списка как ориентир для обучения?

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