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

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

Как использовать API-ключи Cursor с пользовательским эндпоинтом

Вот как использовать настройки API Cursor с вашим собственным эндпоинтом: вставьте ключ, переопределите базовый URL OpenAI и добавьте имя модели uncensored. Описанные ниже шаги занимают около пяти минут и включают проверку curl, которую можно запустить сначала.

Обновлено

Изометрический редактор кода, соединённый светящимся кабелем с серверным кубом, иллюстрирующий пользовательский API-эндпоинт

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

  • Cursor позволяет переопределить базовый URL OpenAI и ключ, поэтому любой OpenAI-совместимый эндпоинт может обрабатывать запросы.
  • Используйте базовый URL https://api.cursorapikey.com/v1 и идентификатор модели uncensored.
  • Проверьте ключ с помощью curl, прежде чем взаимодействовать с редактором, чтобы понять, с какой стороны возникла ошибка.
  • Промпт на 20 000 токенов с ответом на 1 000 токенов стоит $0,0035.

Что включает это руководство

Люди, которые ищут, как использовать API Cursor, обычно имеют в виду одно из двух. Либо они хотят вызывать сервис Cursor из кода, либо хотят, чтобы редактор Cursor отправлял запросы модели на выбранный ими эндпоинт. Это руководство о втором случае. Этот сайт — независимый облачный API, использующий протокол OpenAI chat completions, поэтому Cursor может общаться с ним так же, как с любым сервером в стиле OpenAI.

Модель, стоящая за этим, — одна модель с открытыми весами, запущенная независимым провайдером и настроенная на ответы без отказов в контенте для законного использования взрослыми. Это не официальная модель Cursor и не маршрутизатор между поставщиками. Она обрабатывает только текст. Для кодирования этого обычно достаточно: вы отправляете код и инструкции, получаете код и объяснения обратно.

Вам нужны три вещи: API-ключ, базовый URL https://api.cursorapikey.com/v1 и идентификатор модели uncensored. Всё остальное — вопрос поиска нужных полей в редакторе.

Шаг 1: получите ключ и проверьте его через curl

Зарегистрируйтесь через Google или с помощью электронной почты и пароля, затем откройте страницу API-ключа. На новых аккаунтах можно одним нажатием активировать пробный баланс $0,50. Карта не нужна, срок действия — 7 дней. Пробный ключ ограничен 2 параллельными запросами и 60 запросами в минуту, чего достаточно для первой сессии в редакторе.

Перед тем как открыть Cursor, подтвердите работоспособность ключа. Выполните это в терминале, с вашим ключом в переменной окружения:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

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

Шаг 2: настройте базовый URL и ключ в Cursor

Откройте настройки Cursor и перейдите в раздел моделей. Названия меню и макет меняются между релизами, поэтому воспринимайте метки ниже как карту и проверяйте документацию Cursor, если что-то сдвинулось.

  1. Найдите поле для ключа API OpenAI и вставьте свой ключ с этого сайта.
  2. Включите опцию переопределения базового URL OpenAI и введите https://api.cursorapikey.com/v1. Оставьте /v1 в конце и не добавляйте /chat/completions; клиентское приложение добавляет путь само.
  3. Добавьте пользовательскую модель и введите uncensored точно, строчными буквами.
  4. Используйте кнопку проверки или сохранения, если редактор их предлагает, затем выберите новую модель в панели чата.

Отправьте короткое сообщение, например «объясни эту функцию», с открытым файлом. Потоковый ответ означает, что маршрут работает от начала до конца. Cursor отправляет запрос, эндпоинт потоково передаёт токены обратно через SSE, а редактор отображает их по мере поступления.

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

Протестируйте тот же эндпоинт из кода

Самый простой способ изолировать проблему — вызвать эндпоинт с помощью официального SDK OpenAI. Если это работает, эндпоинт в порядке, и любая оставшаяся проблема находится в конфигурации редактора.

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

То же самое в Node:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

Потоковые ответы включают информацию об использовании в конце, поэтому вы можете точно зафиксировать, сколько токенов использовал запрос. Каждый ответ также содержит заголовок X-Balance-USD с вашим оставшимся балансом и X-Request-Id, который вы можете указать, если что-то выглядит неправильно.

Что работает в рабочем процессе кодирования

API поддерживает потоковую передачу, JSON-режим и вызов функций (tools, tool_choice, потоковые tool_calls и результаты, возвращаемые как role: "tool"). Настройки сэмплирования, такие как temperature, top_p, stop, seed и штрафы, передаются напрямую. Контекстное окно составляет 100 000 токенов, которые делятся между промптом и завершением, а max_tokens является необязательным параметром.

Эти 100 000 токенов — щедрый бюджет для кода. Исходный файл на несколько сотен строк — это несколько тысяч токенов, поэтому вы можете включить несколько файлов плюс длинную инструкцию и всё равно оставить место для ответа. Максимальный размер тела запроса составляет 8 МБ, чего вы не достигнете с текстом.

Некоторые привычки, которые делают пользовательскую модель приятной в редакторе:

  • Держите низкое значение temperature для правок кода. Значения около 0,2 дают более стабильный вывод; повышайте его только для мозгового штурма.
  • Прикрепляйте только файлы, которые имеют значение. Каждый отправленный токен оплачивается как вход, и весь диалог отправляется снова на каждом шаге.
  • Запросите diff или изменённую функцию, а не весь файл, когда файл длинный. Выходные токены стоят дороже входных.
  • Используйте модель для задач, где отказы мешают, например, написание доказательств концепции эксплойтов для вашей собственной лаборатории, анализ образцов вредоносного ПО, которое вы имеете право изучать, или генерация тестовых данных, имитирующих неприятный реальный контент. Всё это должно быть законным.

Единственное жесткое ограничение, которое стоит повторить: никакого сексуального контента с участием несовершеннолетних ни при каких формулировках.

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

СимптомВероятная причинаИсправление
401 или «неверный ключ»Ключ скопирован с пробелом или это старый ключСкопируйте снова со страницы ключа; проверьте через curl
404 или «модель не найдена»Имя модели введено иначеИспользуйте uncensored, строчными буквами, без суффикса
404 на путиБазовый URL включает /chat/completionsЗакончите базовый URL на /v1
429 с concurrencyСлишком много запросов одновременноПодождите завершения потоков; полный ключ позволяет 8, пробный ключ — 2
429 с rate_limitedБолее 300 запросов в минуту (60 на пробном балансе)Уменьшите частоту запросов или повторите попытку после паузы
429 с Retry-After: 5Временная перегрузкаПовторите попытку через пять секунд

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

Сколько стоит сессия кодирования

Цены: $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов, оплачивается из предоплаченного баланса без подписки. Типичный запрос редактора имеет большой промпт (ваши файлы) и короткий ответ. Возьмите 20 000 входных токенов и 1 000 выходных токенов:

  • Вход: 20 000 x $0,15 / 1 000 000 = $0,0030
  • Выход: 1 000 x $0,50 / 1 000 000 = $0,0005
  • Итого: $0,0035 за запрос

При 100 запросах в рабочий день это $0,35. Пробный баланс $0,50 покрывает примерно 140 таких запросов. После окончания пробного периода вы можете пополнить любую целую сумму от $20 до $500, с бонусом +5% от $50, +10% от $100 и +15% от $200. Оплатите криптовалютой (USDT на TRC20, USDC на Base). Баланс не сгорает, поэтому пополнение, которое вы используете медленно, не пропадет. На странице тарифов приведена полная таблица, а страница альтернативы Cursor и Copilot объясняет, как это вписывается в экосистему редакторов по подписке.

Промпты не используются для обучения.

01

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

Работает ли это с агентом Cursor и вызовом функций?

API поддерживает вызов функций с параметрами tools, tool_choice и потоковой передачей tool_calls. Использует ли конкретная функция Cursor вашу пользовательскую модель, зависит от редактора, поэтому протестируйте каждую функцию после настройки.

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

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

Это официальный API Cursor?

Нет. Это независимое OpenAI-совместимое API, работающее поверх одной модели с открытыми весами. Cursor просто позволяет направить настройки OpenAI на другой эндпоинт.

Нужна ли карта для пробного использования?

Нет. Пробный баланс $0,50 активируется одним нажатием на странице API-ключа после регистрации, не требует привязки карты и действителен в течение 7 дней.

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

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