Это официальный API-ключ Cursor?

Нет. Это независимый размещённый API со своими ключами. Он не принадлежит и не связан с вендором Cursor, и его ключ работает только с базовым URL этого сервиса.

Где найти настройку базового URL в Cursor?

Перейдите в раздел «Модели» в настройках, найдите раздел ключа OpenAI API и опцию переопределения базового URL. Названия могут отличаться в разных версиях, поэтому воспользуйтесь поиском по настройкам для поиска по запросу base URL.

Могу ли я сохранить текущую подписку и добавить этот ключ?

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

Что произойдёт, если я потеряю или утечёт ключ?

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

API-ключ Cursor AI: куда вставить пользовательский ключ

Краткий ответ

Редакторам семейства Cursor для работы с пользовательским провайдером нужны три значения: базовый URL, API-ключ и имя модели. Для этого сервиса они:

Базовый URL: https://api.cursoraiapikey.com/v1
API-ключ: ключ со страницы API-ключ
Имя модели: uncensored

Откройте настройки редактора и найдите раздел модели. Cursor предлагает поле для ключа API OpenAI и опцию для переопределения базового URL OpenAI, но метки меню меняются от версии к версии, поэтому ищите в настройках «base URL», если не можете их найти. Вставьте URL и ключ, добавьте пользовательскую модель с именем uncensored, затем используйте кнопку проверки, если она есть в вашей версии.

Этот сервис независим от Cursor. Это отдельный размещённый API, который не заменяет аккаунт или тариф редактора. Вы просто указываете чату редактора другой сервер, совместимый с OpenAI.

Два вида ключей, два разных места

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

Вход в аккаунт

У редактора есть собственный вход в систему. Он идентифицирует вас у вендора редактора и не имеет ничего общего с провайдером моделей. Вы не вставляете ключ провайдера в экран входа.

Ключ провайдера

Это секретная строка, выданная компанией, управляющей моделью. Вы вставляете её в настройки модели вместе с базовым URL, и редактор отправляет её в заголовке Authorization: Bearer при каждом запросе. Ключ от этого сервиса работает только с базовым URL этого сервиса, а ключ от другого провайдера здесь не сработает.

Если вы попали сюда в поисках способа получить собственный ключ редактора бесплатно, то это не про это. Если вам нужна дешёвая текстовая модель за панелью чата редактора, читайте дальше. Тот же принцип работает для любого редактора, который принимает эндпоинт, совместимый с OpenAI, а статья о замене ключа Claude описывает аналогичный случай для конфигураций в стиле Anthropic.

Протестируйте эндпоинт перед тем, как трогать редактор

Двухминутный тест вне редактора покажет, в чем проблема: в ключе или в редакторе. Создайте аккаунт, получите пробный баланс на странице ключа и выполните:

curl https://api.cursoraiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ok."}]
  }'

Вы должны получить JSON-тело с массивом choices. В заголовках ответа есть X-Balance-USD, показывающий остаток на вашем балансе. Тот же вызов на Python с официальным SDK:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.cursoraiapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

Если оба вызова работают, ключ в порядке, и любая последующая ошибка связана с настройками редактора.

Пошаговая настройка в редакторе

Зарегистрируйтесь через Google или по электронной почте и паролю, затем получите $0,50 пробного баланса на странице API-ключ. Карта не нужна, срок действия — 7 дней.
Скопируйте ключ. Относитесь к нему как к паролю.
В редакторе откройте Настройки и перейдите в раздел Модели. Названия различаются в разных версиях, поэтому используйте названия из этого списка как ориентир.
Вставьте ключ в поле ключа API OpenAI.
Включите опцию переопределения базового URL OpenAI и введите https://api.cursoraiapikey.com/v1. Оставьте /v1 и не добавляйте /chat/completions; клиент добавит остальное самостоятельно.
Добавьте пользовательскую модель с точным именем uncensored.
Выберите эту модель в панели чата и отправьте короткое сообщение.

Если в вашей версии есть шаг проверки и он завершается ошибкой, хотя curl работает, убедитесь, что вы не оставили пробел в конце ключа и что в базовом URL нет второго /v1 в конце.

Что будет и что не будет использовать ваш ключ

Установка пользовательского эндпоинта не обязательно меняет все функции. Редакторы часто запускают некоторые функции, такие как встроенное дополнение или применение diff, на моделях, которые сам вендор размещает у себя, и они могут игнорировать ваш ключ. Запросы в стиле чата и агента — это то, что обычно отправляется на настраиваемый вами эндпоинт. Документация редактора является авторитетом для вашей версии, поэтому проверьте её, прежде чем планировать работу с конкретной функцией.

Еще две вещи, которые стоит проверить:

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

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

Исправление распространенных ошибок

Симптом	Вероятная причина	Исправление
401 unauthorized	Неверный или отозванный ключ, лишний пробел, ключ вставлен в неправильное поле	Сгенерируйте новый ключ на странице ключа и вставьте его снова. Старый ключ перестает работать немедленно.
404 не найдено	В базовом URL отсутствует `/v1` или удвоение `/v1/v1`	Используйте ровно `https://api.cursoraiapikey.com/v1`.
Модель не найдена	Имя пользовательской модели введено иначе	Имя — `uncensored`, все буквы строчные.
429 с `concurrency`	Слишком много запросов одновременно; пробные ключи позволяют 2 параллельных запроса	Подождите завершения текущих запросов или перейдите на полный ключ, который позволяет до 8 параллельных запросов.
429 с `rate_limited`	Превышен лимит запросов в минуту; 60 для пробного ключа, 300 для полного ключа	Снизьте скорость; циклы агентов могут создавать всплески запросов.
429 с `Retry-After: 5`	Временная перегрузка	Повторите запрос через пять секунд.

Режимы агентов могут отправлять несколько запросов одновременно, а потоковая передача (streaming) удерживает слот до завершения потока. На пробном ключе легко достичь лимита параллельных запросов. Это нормально, а не ошибка ключа.

Стоимость запроса

Оплата по факту: $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов, списывается с предоплаченного баланса. Неудавшиеся или отклонённые запросы не оплачиваются. Типичный запрос в редакторе отправляет открытый файл и историю, скажем, 20 000 входных токенов, и получает 1 500 выходных токенов:

Вход: 20 000 x $0,15 / 1 000 000 = $0,0030
Выход: 1500 × $0,50 / 1 000 000 = $0,00075
Итого: $0,00375, чуть меньше полцента

Таким образом, $0,50 пробного баланса хватает примерно на 133 хода такого размера. Этого достаточно для послеобеденного реального тестирования. Когда вы решите продолжить, пополнение составляет от $20 до $500 целыми суммами, с бонусом 5% от $50, 10% от $100 и 15% от $200, оплачивается криптовалютой (USDT в сети TRC20 или USDC в сети Base). Баланс не сгорает. На странице цены приведена полная таблица, а в документации перечислены все поддерживаемые параметры.