«Llama API Key» — популярный поисковый запрос, но единого продукта за ним нет. 6 июля 2026 года Meta официально закрыла публичную предварительную версию Llama API; сегодня для работы с Llama обычно используют облако, платформу инференса, собственное развёртывание или OpenAI-совместимый шлюз. На каждом маршруте учётные данные разные: где-то это Bearer Token, где-то временные подписанные данные облачного аккаунта, а где-то ключ вообще не нужен.

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

Примечание: Meta и Llama — товарные знаки Meta Platforms, Inc.; другие названия платформ и моделей — товарные знаки соответствующих правообладателей. Статья носит технический характер и не подразумевает аффилированности, агентских или партнёрских отношений с Meta и указанными платформами.

1. Сначала различите четыре вида «Llama API Key»

Маршрут Форма учётных данных Где создаются Кому подходит
Облачный хостинг Роль IAM, временные данные или ресурсный ключ AWS IAM, Microsoft Foundry, консоль Google Cloud Есть облачный договор, нужны аудит и региональный комплаенс
Платформа инференса Bearer API Key Консоль Groq, OpenRouter и подобных Быстрое подключение без эксплуатации GPU
Собственный инференс Собственная авторизация или доверенная внутренняя сеть vLLM, Ollama, llama.cpp Высокие требования к границам данных, есть GPU
Совместимый шлюз API Key шлюза Консоль шлюза Единый вход для нескольких моделей, расчёты в юанях

Одно и то же слово на разных платформах означает разное. Учётные данные IAM облака нельзя вставить в api_key OpenAI SDK; ключ платформы инференса обычно не даёт доступа к модели другого поставщика. Сначала определите тип учётных данных, потом говорите о «получении».

2. Официальный маршрут: Llama API Key от Meta уже история

Meta представила публичную предварительную версию Llama API в 2025 году: управляемый вход api.llama.com и OpenAI-совместимый путь. Эта версия закрыта 6 июля 2026 года; старые запросы получают сообщение о прекращении сервиса или указание на перенаправление, старые ключи обычно больше не работают. Если видите руководство «создайте Llama API Key в консоли Meta», сначала проверьте дату публикации.

Нужно различать две вещи: веса модели и управляемый API. Открытые веса Llama по-прежнему предоставляются по Llama Community License и доступны на странице моделей Meta и на Hugging Face; закрылся именно собственный управляемый слой Meta. Сейчас Meta продвигает Meta Model API с моделями серии Muse, а не Llama; эти вещи нельзя смешивать.

Поэтому сегодня «официальный ключ» может означать только два варианта: вы скачали веса по официальному каналу и сами реализовали авторизацию, либо вызываете модель через облако или хостинг-провайдера. Любую стороннюю страницу, обещающую «официальный ключ Meta Llama API», нужно сначала проверить.

3. Облака: вы получаете данные IAM, а не ключ для вставки

AWS Bedrock. Сначала запросите доступ к модели в консоли, затем выдайте вызывающей стороне минимальные права bedrock:InvokeModel и bedrock:InvokeModelWithResponseStream. Вызовы используют подпись SigV4, обычно через SDK или временные данные; долгосрочный ключ в код писать не нужно. Для Llama 4 Scout Bedrock сейчас поддерживает только Invoke или Converse API и не предоставляет вход Chat Completions; ID модели выглядит как meta.llama4-scout-17b-instruct-v1:0, для межрегионального инференса добавляется префикс вроде us., а доступность зависит от региона и жизненного цикла.

Microsoft Foundry (ранее Azure AI Foundry). После развёртывания модели Llama из каталога используйте endpoint ресурса с ключом или идентичность Entra ID. Ключ привязан к ресурсу; при смене подписки или региона его нужно подтверждать заново.

Google Cloud Vertex AI. Вызов идёт через сервисный аккаунт или учётные данные приложения по умолчанию; выдайте аккаунту роли Vertex AI и проверьте проект, регион и версию модели. Учитывайте жизненный цикл: Google объявила о выводе llama-3.3-70b-instruct-maas 21 октября 2026 года; командам, которые ещё используют эту модель, нужна миграция или собственное развёртывание.

Общее у облачного маршрута — тонкая гранулярность прав и полная цепочка аудита, но долгое подключение и много статей счёта. Ключ не должен выдаваться человеку: привязывайте его к идентичности рабочей нагрузки и ограничивайте исходную сеть и доступные регионы.

4. Платформы инференса и совместимые шлюзы: самый частый Bearer Key

Платформы инференса Groq, OpenRouter, Fireworks и китайские OpenAI-совместимые шлюзы обычно предоставляют консоль, где на странице API Keys создаётся Bearer Token. Шаги в целом одинаковы:

  1. Зарегистрируйте аккаунт и пройдите требуемую платформой проверку почты, телефона или компании.
  2. Перейдите на страницу API Keys, создайте ключ и укажите в названии проект, среду и пользователя, например prod-rag-cn.
  3. Выберите минимальные права: только инференс, без доступа к счетам, управлению участниками или ключами.
  4. Задайте бюджет, лимит скорости или месячный предел, чтобы один ключ не израсходовал весь аккаунт.
  5. Сразу скопируйте ключ в менеджер паролей или сервис управления секретами; большинство платформ показывает его только при создании.
  6. Проверьте ключ, Base URL и имя модели минимальным запросом, затем записывайте в рабочую конфигурацию.

Отличие шлюза — один ключ может соответствовать нескольким моделям разных поставщиков. В ZSQH AI Gateway Base URL — https://ai.zhongshangqihang.com/v1, доступные модели — по консоли и странице цены на модели. Плюс — единые счета и журналы, цена — дополнительный слой пересылки; при выборе проверьте путь данных, обработку сбоев и правила тарификации.

5. Права: ключ не должен быть всемогущим

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

Частый антипаттерн в командах — «один ключ на всех». При проблеме невозможно понять, кто сделал вызов, а после утечки нельзя отозвать доступ только у одного человека. Разделите ключи по проектам и добавьте теги расхода и оповещения — диагностика станет заметно дешевле.

6. Переменные окружения и код: не пускайте ключ в Git

# .env хранится только локально или в сервисе секретов, не коммитится в Git
export LLAMA_API_KEY="ваш-ключ"
export LLAMA_BASE_URL="https://api.groq.com/openai/v1"
export LLAMA_MODEL="llama-3.3-70b-versatile"

SDK для Python, Node и других языков часто читают OPENAI_API_KEY, если параметр не передан явно. Если в том же процессе вызываются другие провайдеры, передавайте api_key явно, чтобы ключ платформы A не ушёл на платформу B. В контейнерах и службах systemd убедитесь, что переменные действительно внедрены, а не действуют только в текущей оболочке.

При 401 проверяйте по порядку:

  • Заголовок Authorization: Bearer <key>, после Bearer один пробел.
  • Ключ относится к платформе текущего Base URL; межплатформенные ключи не взаимозаменяемы.
  • Ключ не отозван, не истёк и был включён после создания.
  • В переменной нет кавычек, перевода строки или случайного пробела при копировании.
  • Процесс службы прочитал новые переменные; после изменения был перезапуск.
  • 401 — идентичность не подтверждена, 403 — идентичность подтверждена, но прав недостаточно; не смешивайте.

7. Ротация и отзыв: продумайте выход заранее

  1. Создайте на платформе новый ключ с датой в названии, например prod-2026-10.
  2. Сначала замените его в тестовом сервисе или на экземпляре с небольшой долей трафика, наблюдайте 401, 403 и задержку.
  3. Убедитесь, что в журналах нет ошибок аутентификации, затем постепенно замените остальные среды.
  4. Некоторое время держите новый и старый ключи одновременно, но не дольше одного цикла релиза.
  5. Убедившись, что старый ключ не вызывается, отзовите его и проверьте недавний расход на аномалии.
  6. Обновите реестр ключей: дата создания, ответственный, назначение, дата следующей ротации.

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

Частые вопросы

Можно ли сейчас получить официальный Llama API Key от Meta?

Нет. Публичная предварительная версия Llama API от Meta закрыта 6 июля 2026 года, старый вход больше не предоставляет инференс. Веса Llama доступны для скачивания, управляемые вызовы идут через облако, платформу инференса или совместимый шлюз.

Почему у облака нет ключа, который можно просто вставить?

Облака обычно используют роли IAM, сервисные аккаунты или временные данные, а права и аудит привязаны к облачному аккаунту. Это тоньше долгосрочного Bearer Token, но перед подключением нужно настроить права и подпись; параметр api_key OpenAI SDK напрямую не подходит.

Один ключ вызывает все модели Llama?

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

Что будет, если положить ключ во фронтенд или приложение?

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

Что проверять первым при 401 и 403?

При 401 — сам ключ, формат заголовка и соответствие Base URL; при 403 — есть ли у ключа или роли права на нужную модель, проект или регион. После этого смотрите страницу статуса шлюза или облака.

Что дальше

Сначала определите маршрут, затем создайте отдельный ключ: в облаке — через IAM, на платформе инференса и в шлюзе — Bearer Token, при собственном хостинге — свою авторизацию. Если нужны единый ключ, журналы и вход к нескольким моделям, начните с регистрации в ZSQH AI Gateway; доступные модели и тарификация — на странице цены на модели.

Связанные материалы: