Премини към основното съдържание
Български— Изберете език
Меню

Удостоверяване, API ключове и организация

Урок 3 от 22 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Удостоверяване, API ключове и организация
  2. Създайте акаунта си и вземете ключ
  3. Кой тип ключ да изберете
  4. Организации и проекти
  5. Никога не излагайте ключовете си
  6. Проверете конфигурацията си
  7. Ключови изводи

Удостоверяване, API ключове и организация

Преди да напишете и ред код, трябва да конфигурирате достъпа си до API. Този урок обхваща създаването на ключове, структурирането на достъпа чрез организации и проекти, както и мерките за сигурност, които предотвратяват класическия кошмар: случайно качване на ключ в публично хранилище, където непознат да го използва през нощта.

Създайте акаунта си и вземете ключ

Процесът отнема три стъпки. Първо, отидете на platform.openai.com и създайте акаунт; автоматично ще получите безплатни кредити, за да започнете експерименти. След това навигирайте до секцията API Keys в таблото за управление и генерирайте нов ключ. Ще видите този ключ само веднъж: копирайте го незабавно, но не го поставяйте директно в кода си.

# Вашият API ключ изглежда така (никога не го споделяйте!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Най-добра практика: използвайте променлива на средата
import os
api_key = os.environ.get("OPENAI_API_KEY")

Третата стъпка е декларирането на променливата на средата, което зависи от вашата платформа. На машина за разработка файл .env, зареден чрез python-dotenv, често е най-удобният вариант. На сървър предпочитайте променлива на средата, дефинирана от вашия оркестратор или услуга за тайни.

# Linux / macOS — добавете към ~/.bashrc или ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"

# .env файл (с python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here

Кой тип ключ да изберете

Ключовете за проекти, разпознаваеми по префикса си sk-proj-, са свързани с конкретен проект и предлагат най-добър контрол. Ще ги използвате в почти всеки случай. SDK ги открива автоматично, щом променливата на средата е зададена, затова OpenAI() се инстанцира без аргументи във всички примери в този курс.

from openai import OpenAI

# SDK автоматично открива OPENAI_API_KEY
client = OpenAI()

# Или посочете изрично (не се препоръчва за продукция)
client = OpenAI(api_key="sk-proj-...")

Сервизните ключове са вторият тип. Проектирани за сървърни приложения, изискващи повишен достъп, те предоставят допълнителни разрешения и следователно изискват допълнителни грижи: съхранявайте ги в хранилище за тайни и никога не разпространявайте стойността им до работна станция за разработка.

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

Достъпът е структуриран на три нива на влагане:

  1. Организация: Вашата компания или екип
  2. Проект: Логическо групиране (напр. „Продукционен чатбот“, „Анализ на данни“)
  3. API ключ: Свързан с конкретен проект

Ако принадлежите към няколко организации, посочете тази, която възнамерявате да използвате, при инстанциране на клиента:

from openai import OpenAI

# Посочете организацията (полезно, ако принадлежите към няколко)
client = OpenAI(
    organization="org-xxxxxxxxxxxx",
    project="proj-xxxxxxxxxxxx"
)

Отделете време, за да разделите използването си на проекти, вместо да насочвате всичко през един единствен ключ. Ще видите ползата при първия признак на проблем. Всеки проект има собствен проследяване на използването, което ви позволява да атрибутирате разходите към конкретна функция, а не към непрозрачна месечна сума. Лимитите на скоростта също са разделени: нощна пакетна задача, която насища квотата си, няма да попречи на чатбота ви да отговаря на клиенти. След това можете да възложите различни членове на всеки проект и, което е от решаващо значение, да отмените компрометиран ключ, без да прекъсвате други приложения.

Никога не излагайте ключовете си

Правилото е просто и абсолютно: ключ никога не се появява в изходния код. Контрастът между двата фрагмента по-долу говори по-силно от дълга лекция.

# ЛОШО — ключ, вграден в кода
client = OpenAI(api_key="sk-proj-abc123")  # ОПАСНОСТ!

# ДОБРО — променлива на средата
client = OpenAI()  # Автоматично чете OPENAI_API_KEY

# ДОБРО — .env файл с python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()

Следствието засяга вашия .gitignore, който трябва да изключва локалните конфигурационни файлове преди първия ви комит, а не след това. Ключ, който е публикуван и след това изтрит, остава присутен в историята на хранилището.

# ВИНАГИ добавяйте тези редове към вашия .gitignore
.env
.env.local
.env.production
*.key

Накрая, планирайте редовна ротация на всеки 90 дни. Можете да направите това без престой: създайте нов ключ, актуализирайте вашите внедрявания и след това изтрийте стария едва когато нищо вече не го използва.

Проверете конфигурацията си

Преди да продължите, стартирайте този скрипт. Той проверява наличието на ключ, показва съкратена версия, за да потвърди, че е правилният, и след това прави реално обаждане. Стартирайте отново този тест, когато някоя среда се държи странно.

from openai import OpenAI
import os

def verify_configuration():
    """Проверка дали конфигурацията на API е правилна."""
    
    # Проверка за ключа
    api_key = os.environ.get("OPENAI_API_KEY")
    if not api_key:
        print("ГРЕШКА: OPENAI_API_KEY не е дефинирана")
        return False
    
    print(f"Открит ключ: {api_key[:8]}...{api_key[-4:]}")
    
    # Тестване на връзката
    try:
        client = OpenAI()
        response = client.responses.create(
            model="gpt-5.6-terra",
            input="Reply only: OK"
        )
        print(f"Връзката е успешна: {response.output_text}")
        return True
    except Exception as e:
        print(f"ГРЕШКА във връзката: {e}")
        return False

verify_configuration()
# Очакван резултат:
# Открит ключ: sk-proj-...xxxx
# Връзката е успешна: OK

Ключови изводи

  • Използвайте ключове за проекти (sk-proj-...) за всяко приложение
  • Съхранявайте ключовете си в променливи на средата, никога в кода
  • Организирайте достъпа си с йерархията Организация → Проект → Ключ
  • Извършвайте редовна ротация на ключовете си (на всеки 90 дни)
  • Винаги добавяйте .env към вашия .gitignore