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

Команды и код во всех языковых версиях остаются на английском. Заменяйте ЗАГЛАВНЫЕ заполнители значениями своей учетной записи и оплаченного задания. Не вставляйте реальные ключи в общие ноутбуки или журналы.

Цикл обучения

Цель задает направление работы; настоящая оптимизация изменяет веса модели-ученика.

Цель Определить задачу и критерии приемки
Модель-учитель Подготовить разрешенный эталонный материал
Модель-ученик Обучить в выбранной среде выполнения
Оценка Сравнить с исходным уровнем
Поставка Экспортировать независимую модель или адаптер

Где выполняется работа

API координирует процесс; веса обучаются в среде клиента. Веса модели-учителя не передаются.

Ваше приложение Ключ API, цель и одобренное задание
FusionPointAI API Сеанс, доступ к эталонной модели и подготовленные данные
Среда обучения SDK, модель-ученик и GPU
Локальный результат Пакет модели и отчет об оценке

От цели к отдельной модели

Выберите план провайдера и референсную модель, определите задачу и настройте модель-ученик и среду выполнения. TrainingProject может запросить у модели-учителя одобренные учебные материалы; выбранная среда загружает модель-ученик и обновляет ее веса. Результат — отдельная модель или адаптер, а не копия весов учителя.

Начните с измеримой цели, например классификации немецких документов.
Разделяйте доступ к учителю, модель-ученик, среду выполнения и критерии оценки.
TrainingClient остается доступен для существующих процессов с оплаченными заданиями и сеансами.

Три компонента и три зоны ответственности

Ключ API дает доступ к сервису, но не является GPU. API координирует сеансы, подготовленные данные и отчеты. Среда выполнения предоставляет память, хранилище и вычислительные ресурсы. SDK выполняет локальную оптимизацию и упаковывает результат. Хостинг может предоставляться FusionPointAI, вашим центром обработки данных или совместимой средой ноутбука.

Храните учетные данные отдельно от файлов модели и экспортированных пакетов.
Проверяйте, какая цель и какой учебный материал отправляются эталонной модели.
Отчет о завершении не является независимой сертификацией качества модели.

Выберите порядок чтения

Новым пользователям удобно читать главы «Быстрый старт», «Основные понятия», «Модели», «Наборы данных», «Обучение» и «Оценка» по порядку. Интеграторы могут сразу перейти к справочникам API и Python. Операторам также следует прочитать главы о восстановлении и средах выполнения.

Проверьте план до использования вычислительных ресурсов или запросов к модели-учителю.
Сохраните исходную базовую модель без изменений для сравнения.
Экспортируйте результат только после проверки обучения и его оценки.

Справка по API

Конечная точка	Назначение и поведение
`POST /api/v1/training/quotes` Authorization: Bearer `ai:training`	Проверить подходящую эталонную модель, план и конфигурацию; вернуть UUID предложения, валюту, `fixed_total` и `expires_at`. Используйте одобренный план и допустимые настройки модели-ученика, а не произвольные цены клиента.
`GET /api/v1/training/jobs` Authorization: Bearer `ai:training`	Получить список заданий аутентифицированного клиента. Проверяйте возвращенную коллекцию и идентификаторы ресурсов, а не угадывайте числовые идентификаторы.
`POST /api/v1/training/jobs` Authorization: Bearer `ai:training`	Создать принадлежащее учетной записи задание по действительному UUID предложения. В ответе указаны ID задания, статус, ID счета и временные метки; создание задания не подтверждает оплату.
`GET /api/v1/training/jobs/{job}` Authorization: Bearer `ai:training`	Прочитать свое задание по UUID, включая ход выполнения и статус поставки.
`GET /api/v1/training/jobs/{job}/artifacts/{file}` Authorization: Bearer `ai:training`	Скачать опубликованный файл, принадлежащий этому заданию. ZIP-файл локального SDK автоматически не загружается и может быть недоступен через этот маршрут.
`POST /api/v1/training/sessions` Authorization: Bearer `ai:training`	Тело запроса: UUID задания, среда выполнения и необязательная положительная `reference_model_id`. Вернуть новый или повторно используемый сеанс; менять эталонную модель можно только до начала подготовки.
`GET /api/v1/training/sessions/{session}` Authorization: Bearer `ai:training`	Прочитать принадлежащий клиенту сеанс, его конфигурацию, наборы данных, отчет и состояние. Чтение состояния не запускает обучение.
`POST /api/v1/training/sessions/{session}/prepare` Authorization: Bearer `ai:training`	Отправить пустой объект JSON, чтобы запросить ограниченную порцию подготовки. При наличии прогресса повторять запрос до готовности с учетом бюджета запросов.
`GET /api/v1/training/sessions/{session}/datasets/{split}` Authorization: Bearer `ai:training`	Скачать `train` или `validation` в формате `application/x-ndjson`. Сверить байты, SHA-256 и строки с манифестом соответствующего сеанса.
`POST /api/v1/training/sessions/{session}/events` Authorization: Bearer `ai:training`	Сообщить фактическое состояние, `step`, `total_steps` и необязательные метрики `loss`/`eval_loss`. Использовать только поддерживаемые значения состояния и кода ошибки.
`POST /api/v1/training/sessions/{session}/complete` Authorization: Bearer `ai:training`	Отправить `artifact_name` и полный достоверный отчет об обучении. Сервис проверяет метод, базовую ревизию, изменения весов, дайджест артефакта и критерии оценки.
`POST /api/v1/training/sessions/{session}/cancel` Authorization: Bearer `ai:training`	Отправить пустой объект JSON для отмены состояния сервиса, если это допускается. При необходимости самостоятельно остановить отдельный процесс GPU; это не пауза и не возобновление.
`POST /api/v1/training/projects/authorize` Authorization: Bearer `ai:training`	Отправьте POST `/api/v1/training/projects/authorize` с параметрами `provider` и положительным `reference_model_id`. Сервис повторно проверит оплаченный доступ учетной записи к референсной модели и вернет принадлежащие ей задание и разрешение, провайдера, референсную модель и срок действия. Счет не создается, платеж не меняется.
`POST /api/v1/training/projects/teacher` Authorization: Bearer `ai:training`	Отправьте POST `/api/v1/training/projects/teacher` с параметрами `provider`, `reference_model_id`, `action` (`curriculum` или `lessons`), `objective`, необязательным `topic`, `count` (1–4) и не более чем восемью `approved_examples` (до 2 000 символов каждый). В ответе будут темы или строки с текстом урока и темой. Отправляйте только одобренные учебные данные, никогда не передавайте данные валидации или итогового теста.

FAQ

Можно ли запустить автоматический процесс, указав одну цель?

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

Получаю ли я исходные веса модели-ориентира?

Автоматическая передача не подразумевается. Пользовательская модель обучается отдельно, а передаваемые материалы и лицензия определяются в одобренной смете.

Совпадает ли качество модели с моделью-ориентиром?

Безусловной гарантии нет. Согласованные целевые возможности оцениваются по документированным тестам, а измеренные результаты указываются в отчёте.

Нужно ли покупать хостинг?

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

Что происходит с включённым доступом к API после окончания периода?

Доступ прекращается по завершении указанного периода обучения. Затем можно выбрать отдельную доступную подписку Unlimited API.

Включает ли один план обучения поставщика несколько моделей-ориентиров?

Да. Одна подписка включает все доступные модели-ориентиры этого поставщика на оплаченный срок. Для каждой сессии выберите или смените модель до начала подготовки данных; отдельная подписка для этого не нужна. Доступ заканчивается в дату истечения срока и может быть отозван раньше.