RU ▾
Получить API-ключ

cursorapikey.com/Руководство

Ключи API Cursor не работают: исправления для пользовательского эндпоинта

Когда ключи API Cursor не работают, причина почти всегда одна из четырёх: базовый URL, имя модели, сам ключ или лимит аккаунта. Одна команда curl покажет, какая именно.

Обновлено

Абстрактная панель редактора кода с подсвеченным ключом, который вставляется, и гаечным ключом с лупой рядом
Изометрическая вилка с путями к редактору, серверу и терминалу, иллюстрирующая выбор альтернативы Cursor

Ключевые моменты

  • Сначала проверьте ключ вне Cursor с помощью curl; если curl работает, проблема в настройках Cursor.
  • Базовый URL должен быть https://api.cursorapikey.com/v1, а имя модели — точно uncensored.
  • 401 означает неверный ключ, 404 — неверный URL, 429 — лимит частоты или параллельных соединений, а ошибка модели — неверное имя.
  • Названия в меню меняются между версиями Cursor, поэтому ориентируйтесь на назначение поля, а не на точные формулировки.

Шаг 1: проверьте ключ вне Cursor

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

curl -i https://api.cursorapikey.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 ready."}]}'

Флаг -i выводит строку статуса и заголовки. Статус 200 с массивом choices означает успех. Заголовок X-Balance-USD показывает ваш оставшийся кредит, что является первым, что нужно проверить при ошибках авторизации или оплаты.

Вы также можете вывести список моделей, что подтвердит ключ без траты средств:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

В ответе должен быть идентификатор модели uncensored.

Шаг 2: настройте поля в Cursor

Откройте настройки Cursor и найдите раздел Models. Вам понадобятся три значения, и ошибка в любом из них приведет к сбою, который выглядит как сломанный ключ.

  1. Ключ OpenAI API: вставьте свой ключ без пробелов или разрывов строк в начале и конце.
  2. Переопределите базовый URL OpenAI: включите переопределение и введите https://api.cursorapikey.com/v1. Оставьте /v1 и уберите /chat/completions.
  3. Кастомная модель: добавьте модель с именем uncensored и включите её. Отключите неиспользуемые модели, чтобы Cursor не выбрал ту, которую не знает эндпоинт.

После сохранения используйте опцию проверки, если она есть в вашей версии, затем выберите uncensored в выпадающем списке модели чата. Новый чат — хороший тест, так как старый чат может сохранить модель, с которой был запущен. Пошаговое руководство в как использовать API Cursor показывает ту же настройку в контексте.

Сопоставьте ошибку с решением

Что вы видитеВероятная причинаИсправление
401, «неверный ключ», «неавторизован»Ключ введен неверно, усечен или отозванСкопируйте его снова со страницы ключа; проверьте наличие пробелов в конце
404, «не найдено»Неверный URL, отсутствует /v1 или удвоенный путьИспользуйте точно https://api.cursorapikey.com/v1
«модель не найдена» или аналогичноеИмя модели отличается от uncensoredДобавьте пользовательскую модель с точным именем, строчными буквами
429 с rate_limitedПревышен лимит запросов в минутуУменьшите частоту запросов; пробные ключи позволяют 60 в минуту, полные ключи — 300
429 с concurrencyСлишком много запросов одновременноУменьшите количество параллельных запусков агентов; пробный — 2, полный ключ — 8
429 с Retry-After: 5Временная перегрузкаПодождите пять секунд и повторите попытку
Работает в curl, не работает в CursorНастройка не сохранена, неверная модель в выбранной вкладке или функция, которая не использует пользовательские ключиСмотрите следующий раздел

Неудачные или отклоненные запросы не оплачиваются, поэтому повторные попытки при отладке ничего не стоят.

Когда curl работает, но Cursor все еще не работает

Это самый запутанный случай, и у него есть несколько обычных объяснений.

Выбрана неверная модель. Cursor сохраняет свои встроенные модели в списке. Если выбрана одна из них, запрос вообще не идет на ваш эндпоинт. Явно выберите uncensored в выпадающем списке чата или композера, который вы используете.

Не все функции используют ваш ключ. Функции, зависящие от собственных моделей Cursor, таких как встроенный автодополнение, могут продолжать их использовать независимо от добавленного ключа. Кастомные ключи применяются там, где можно выбрать модель, то есть в режимах чата и редактирования. Проверьте текущую документацию Cursor, так как это меняется между релизами.

Параллельные запросы из режима агента. Агенты и многошаговые запуски могут отправлять несколько запросов одновременно. Пробный ключ позволяет два одновременно. Если ошибки появляются только в режиме агента, вы, вероятно, упираетесь в лимит concurrency, а полный ключ повышает его до восьми. Потоковый запрос удерживает слот до конца потока, поэтому длинные ответы занимают слоты дольше.

Вызов функций. API поддерживает вызов функций, с tool_calls потоковой передачей и результатами, возвращаемыми как role: "tool". Качество использования функций зависит от модели, поэтому если запуск агента зависает на шаге функции, попробуйте выполнить ту же задачу в обычном чате.

Проверьте настройки аккаунта

Если curl возвращает ошибку о балансе, ключ действителен, но кредит исчерпан или пробный период истек. Пробный период составляет $0,50, действителен в течение 7 дней, оформляется в один клик на странице API-ключа после регистрации. После этого необходимо пополнение.

Пополнение — любая целая сумма от $20 до $500, с бонусом +5% от $50, +10% от $100 и +15% от $200. Вы можете оплатить криптовалютой (USDT в сети TRC20, USDC в сети Base). На странице с ценами показана таблица. Если у вас еще нет ключа, получите его здесь.

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

Проверка скриптом для упорного случая

Если вы все еще не можете найти причину, запустите короткий скрипт, который дублирует действия редактора. Он использует SDK OpenAI, на котором основаны клиенты, совместимые с Cursor, и выводит точный объект ошибки.

from openai import OpenAI, APIStatusError

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

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

Если скрипт потоково передает текст, эндпоинт, ключ и модель верны, и оставшаяся проблема — в настройке Cursor. Если он выводит код статуса, используйте таблицу выше. Сохраните значение X-Request-Id при обращении в поддержку, так как оно идентифицирует конкретный запрос. Полные параметры на странице документации.

Предотвратите повторные сбои

Несколько привычек предотвращают большинство повторяющихся проблем. Храните ключ в одном элементе менеджера паролей и копируйте оттуда, а не из журналов чата или заметок, где могут проскочить разрывы строк. Запишите три значения (базовый URL, ключ, имя модели), чтобы ввести их снова после обновления редактора, так как обновления иногда сбрасывают переопределения. После каждого обновления отправьте короткое сообщение в чат перед началом реальной работы.

Следите за балансом. Заголовок X-Balance-USD возвращается в каждом ответе, и вы также можете прочитать его из GET /v1/balance. Кредит не сгорает, поэтому умеренное пополнение на аккаунте не пропадет. Если вы используете ключ из скриптов, а также из редактора, дайте длинным пакетным задачам цикл повторных попыток с ожиданием пять секунд при 429 и остановкой после нескольких попыток, чтобы скрипт не лишил редактор слотов параллельных запросов.

Запрос на чат для кодирования с 10 000 токенов контекста файла и ответом в 700 токенов стоит 10 000 / 1 000 000 x $0,15 = $0,0015 за ввод и 700 / 1 000 000 x $0,50 = $0,00035 за вывод, всего около $0,00185. Тарифы: $0,15 за 1M входных и $0,50 за 1M выходных токенов. Статья на странице цен Cursor API охватывает ежемесячные оценки.

Если запрос, который не удался, был большим, помните о контекстном окне: промпт плюс завершение должны уместиться в 100 000 токенов, а тело запроса ограничено 8 МБ. Прикрепление всего репозитория к чату может превысить оба лимита. Обрежьте контекст, оставив только важные файлы, и попробуйте снова.

01

Вопросы и ответы

Почему Cursor говорит, что мой API-ключ недействителен?

Обычно в ключе есть лишний пробел или он был скопирован частично, либо базовый URL все еще указывает на другой сервис. Скопируйте ключ заново, затем убедитесь, что URL переопределения — https://api.cursorapikey.com/v1.

Какое имя модели я должен ввести?

Введите uncensored, строчными буквами. Это единственный идентификатор модели, который предлагает API.

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

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

Считываются ли неудачные запросы?

Нет. Неудачные или отклонённые запросы не тарифицируются, поэтому повторные попытки при отладке ничего не стоят.

Ваш ключ — всего в одной форме

Создайте учётную запись, скопируйте ключ, измените базовый URL. Это вся настройка.