API-ключ OpenAI

Чтобы Style Rewriter мог переписывать тексты моделями GPT-4o / GPT-4o-mini, нужен API-ключ от OpenAI. Это пошаговая инструкция: от создания аккаунта до вставки ключа в админку Style Rewriter.

Весь процесс занимает 10–15 минут (дольше чем у Anthropic из-за обязательной верификации телефона). Интерфейс platform.openai.com на английском — все литеральные надписи в инструкции даны в таком виде.

Регистрация

Аккаунт OpenAI Platform — это та же учётная запись, что и для ChatGPT, но с отдельной разработческой площадкой.

Откройте https://platform.openai.com/signup.
Зарегистрируйтесь по email + пароль или через Google / Microsoft / Apple SSO. Если у вас уже есть ChatGPT-аккаунт — используйте его, отдельный платформенный заводить не нужно.
OpenAI пришлёт письмо с подтверждением — кликните по ссылке.
Верификация телефона. OpenAI просит подтвердить номер телефона до выдачи API-ключа. Введите номер, дождитесь SMS, введите код. На один номер можно навесить ограниченное количество аккаунтов (порядок одного-двух), номер РФ принимается, но не всегда стабильно — если SMS не приходит, попробуйте номер другой страны.
На первом экране после регистрации OpenAI спросит организацию (Organization name) и роль. Можно ввести любое — это видно только вам и не влияет на доступ к API.

Российские IP-адреса OpenAI блокирует на уровне регистрации и API-вызовов. Без VPN с экзит-узлом за пределами РФ зарегистрироваться и работать с ключом не получится — Cloudflare покажет блок-страницу либо API вернёт unsupported_country_region_territory. VPN нужен и при регистрации, и при работе бэкенда Style Rewriter (на проде Latvia VPN-узел не нужен, но если запускаете локально — нужен).

Биллинг и оплата

OpenAI работает по предоплате — нужно положить кредиты на баланс до того как ключ сможет делать реальные вызовы. У свежесозданного ключа без баланса каждый запрос вернёт insufficient_quota.

В консоли откройте Settings → Billing (левая панель навигации) или сразу https://platform.openai.com/account/billing/overview.
Нажмите Add payment method, привяжите карту.
Нажмите Add to credit balance. Минимальная сумма пополнения — $5. Для пробных переписываний этого хватит на месяцы; для регулярной работы команды редакторов рекомендуем сразу класть $20–50.
Опционально включите Auto recharge — баланс будет сам пополняться когда упадёт ниже порога.

Российские карты (Visa/MasterCard, выпущенные в РФ) OpenAI не принимает. Нужна иностранная карта (Казахстан / Армения / Грузия / ЕС / США) либо виртуальная карта вроде Wise. Это блокировка по BIN-коду карты — не обходится через VPN.

После пополнения баланс отображается в шапке страницы Billing. Кредиты списываются по мере использования API — цены input-/output-токенов конкретной модели смотрите на странице цен.

Создание API-ключа

Ключ создаётся одной кнопкой и показывается ровно один раз. Если потеряете — придётся выпускать новый.

В консоли откройте https://platform.openai.com/api-keys.
Нажмите + Create new secret key.
Введите название (Name) — оно видно только вам, нужно чтобы отличать ключи в списке. Подойдёт что-то вроде style-rewriter-prod.
Выберите проект в поле Project — у новых аккаунтов есть один Default project, его и берите. Это project-scoped key (новый формат с префиксом sk-proj-); legacy user-scoped keys (просто sk-) больше не выдаются для новых аккаунтов.
В Permissions оставьте All — Style Rewriter использует chat completions endpoint, ограничивать нет смысла.
Нажмите Create secret key.
Скопируйте показанный ключ. Он начинается с sk-proj- и дальше идёт длинная строка из букв, цифр, дефисов и подчёркиваний.

Ключ показывается ровно один раз. После закрытия модалки полная строка больше нигде в консоли не отображается — только последние 4 символа. Скопируйте сразу и вставьте в Style Rewriter (следующий шаг). Если потеряли — удалите ключ в списке и создайте новый.

Вставка в Style Rewriter

В Style Rewriter войдите как админ.
Откройте вкладку ⚙️ Настройки в шапке.
Внутри настроек выберите подвкладку 🔑 API-ключи.
Найдите карточку OpenAI.
Вставьте скопированный ключ в поле ввода (placeholder подсказывает формат sk-proj-...).
Нажмите Сохранить.
Нажмите Тест ключа — кнопка отправит на бэк маленький запрос к OpenAI (несколько токенов, цена ничтожна) и проверит, что ключ работает.
Дождитесь зелёного бейджа «✓ Активен» рядом с карточкой. Если бейдж красный — см. следующий раздел.

После активации ключа модели GPT-4o и GPT-4o-mini появятся в выпадающем списке моделей на основном экране переписывания.

Что делать если ключ не работает

Ниже типичные ошибки от OpenAI и что они значат. Полный список — в документации OpenAI по ошибкам.

invalid_api_key (HTTP 401) — ключ невалидный или удалён. Проверьте, что вставили полную строку (включая префикс sk-proj-) без пробелов в начале/конце. Если проблема осталась — удалите ключ в консоли и создайте новый.
insufficient_quota (HTTP 429) — на балансе нет денег или исчерпан кредитный лимит. Зайдите в Settings → Billing, проверьте остаток кредитов, при нуле — пополните. Это самая частая ошибка у новых ключей: даже с пополненным балансом первое время может выдаваться, если OpenAI ещё не «увидел» оплату — подождите 5–10 минут.
rate_limit_exceeded (HTTP 429) — слишком много запросов в минуту. У новых аккаунтов лимиты низкие (Tier 1), после $5+ потраченных автоматически переводят на Tier 2 с большими лимитами. Подождите минуту и повторите.
unsupported_country_region_territory (HTTP 403) — запрос идёт с заблокированного IP (РФ, Беларусь, Иран и др.). Бэкенд Style Rewriter должен вызывать OpenAI с разрешённого региона. Если вы запускаете локально — подключите VPN.
model_not_found (HTTP 404) — у вашего аккаунта нет доступа к запрошенной модели. Обычно так бывает для самых новых моделей в первые дни релиза, либо если модель доступна только высоким Tier.
permission_denied (HTTP 403) — у ключа нет нужных permissions. Создайте новый ключ с All permissions.

Если Style Rewriter возвращает ошибку с непонятным текстом — откройте DevTools браузера (F12) → вкладка Network → найдите запрос на /api/keys/openai/test → посмотрите Response. Там будет точный код ошибки от OpenAI, который проще нагуглить.