Link to this sectionAPI-ключи#

API-ключи Ultralytics Platform обеспечивают безопасный программный доступ для удаленного обучения, логического вывода и автоматизации. Создавай именованные ключи с шифрованием AES-256-GCM для различных сценариев использования.

Link to this sectionСоздать API key#

Создай новый API-ключ:

1. Перейди в Settings > API Keys
2. Нажми Create Key
3. Введи название ключа (например, "Training Server")
4. Нажми Create Key

Link to this sectionНазвание ключа#

Дай своему ключу описательное название:

• training-server — для удаленных машин обучения
• ci-pipeline — для CI/CD интеграции
• local-dev — для локальной разработки

Link to this sectionОтображение ключа#

После создания ключ отображается один раз:

Link to this sectionФормат ключа#

API-ключи имеют следующий формат:

• Префикс: ul_ идентифицирует ключи Ultralytics
• Тело: 40 случайных шестнадцатеричных символов
• Всего: 43 символа

Link to this sectionБезопасность ключей#

• Ключи хранятся с использованием шифрования AES-256-GCM
• Для аутентификации используется хеш SHA-256 для быстрого индексированного поиска
• Полные значения ключей никогда не хранятся в открытом виде

Link to this sectionИспользование API-ключей#

Link to this sectionПеременная окружения#

Установи ключ в качестве переменной окружения:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

Link to this sectionYOLO CLI#

Установи ключ с помощью YOLO CLI:

yolo settings api_key="YOUR_API_KEY"

Link to this sectionВ коде#

Используй ключ в своих скриптах Python:

import os

# From environment (recommended)
api_key = os.environ.get("ULTRALYTICS_API_KEY")

# Or directly (not recommended for production)
api_key = "YOUR_API_KEY"

Link to this sectionHTTP-заголовки#

Включай ключ в API-запросы:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/...

Смотри REST API Reference для получения списка всех доступных эндпоинтов.

Link to this sectionУдаленное обучение#

Включи потоковую передачу метрик с помощью своего ключа.

pip install "ultralytics>=8.4.60"

export ULTRALYTICS_API_KEY="YOUR_API_KEY"
yolo train model=yolo26n.pt data=coco.yaml project=username/project name=exp1

Смотри Cloud Training для получения полного руководства по удаленному обучению.

Link to this sectionУправление ключами#

Link to this sectionПросмотр ключей#

Все ключи перечислены на вкладке Settings > API Keys:

Каждая карточка ключа показывает его название, полное расшифрованное значение (которое можно скопировать), относительное время создания и кнопку отзыва.

Link to this sectionОтзыв ключа#

Отозови ключ, если он скомпрометирован или больше не нужен:

1. Найди ключ в разделе API Keys
2. Нажми кнопку Revoke (корзина)
3. Подтверди отзыв

Link to this sectionПерегенерация ключа#

Если ключ скомпрометирован:

1. Создай новый ключ с тем же названием
2. Обнови свои приложения
3. Отозови старый ключ

Link to this sectionAPI-ключи рабочего пространства#

API-ключи привязаны к текущему активному рабочему пространству:

• Личное рабочее пространство: Ключи аутентифицируют тебя как личный аккаунт
• Командное рабочее пространство: Ключи аутентифицируют в контексте команды

При переключении рабочих пространств в боковой панели раздел API Keys показывает ключи именно для этого пространства. Для управления API-ключами рабочего пространства требуется роль редактора или выше. Подробности о ролях смотри в Teams.

Link to this sectionЛучшие практики безопасности#

Link to this sectionДелай#

• Храни ключи в переменных окружения
• Используй отдельные ключи для разных сред
• Своевременно отзывай неиспользуемые ключи
• Периодически меняй (ротируй) ключи
• Используй описательные названия для определения назначения ключей

Link to this sectionНе делай#

• Не коммить ключи в систему контроля версий
• Не делись ключами между приложениями
• Не выводи ключи в логах приложения
• Не встраивай ключи в клиентский код

Link to this sectionРотация ключей#

Периодически меняй ключи в целях безопасности:

1. Создай новый ключ с тем же названием
2. Обнови приложения, чтобы они использовали новый ключ
3. Проверь, что приложения работают корректно
4. Отозови старый ключ

Link to this sectionУстранение неполадок#

Link to this sectionОшибка неверного ключа#

Решения:

1. Проверь, правильно ли скопирован ключ (включая префикс ul_)
2. Убедись, что ключ не был отозван
3. Подтверди, что переменная окружения установлена
4. Убедись, что используешь ultralytics>=8.4.60

Link to this sectionДоступ запрещен#

Решения:

1. Проверь, что ты являешься владельцем ресурса или имеешь соответствующий доступ к рабочему пространству
2. Проверь, что ключ принадлежит нужному рабочему пространству
3. Создай новый ключ, если это необходимо

Link to this sectionПревышение лимита запросов (Rate Limited)#

Решения:

1. Сократи частоту запросов — смотри таблицу лимитов для ограничений по каждому эндпоинту
2. Реализуй экспоненциальную задержку (exponential backoff) с использованием заголовка Retry-After
3. Используй выделенный эндпоинт для неограниченной пропускной способности при логическом выводе

Link to this sectionFAQ#

Link to this sectionСколько ключей я могу создать?#

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

Link to this sectionСрок действия ключей истекает?#

Срок действия ключей автоматически не истекает. Они остаются действительными до момента отзыва. В целях безопасности рассмотри возможность внедрения ротации.

Link to this sectionМогу ли я увидеть свой ключ после создания?#

Да, полные значения ключей видны в списке на Settings > API Keys. Платформа расшифровывает и отображает твои ключи, чтобы ты мог скопировать их в любое время.

Link to this sectionПривязаны ли ключи к регионам?#

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

Link to this sectionМогу ли я делиться ключами с членами команды?#

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