Быстрый старт для пользователей Cursor

Базовый URL и аутентификация

Настройте клиент на https://api.cursorapikey.com/v1. Сервис ожидает стандартные заголовки аутентификации OpenAI. Сгенерируйте ключ на странице Получить API-ключ; он понадобится для каждого запроса. Используйте идентификатор модели uncensored для доступа к единственной доступной модели. Эта настройка работает с любым SDK или агентом, совместимым с OpenAI, например Cursor, Claude Code или пользовательскими эндпоинтами GitHub Copilot.

Первый запрос

Проверьте подключение с помощью простого завершения чата. Эндпоинт поддерживает стандартные тела запросов. Если вы получили статус 200, ваша конфигурация верна. Ошибка 401 указывает на недействительный или отсутствующий ключ, а ошибка 402 означает, что ваш предоплаченный баланс исчерпан.

Copycurl 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 blunt product review of a cheap VPN."}]
  }'

Запросы объемом более 8 МБ или более 300 запросов в минуту могут возвращать специфические коды ошибок. Подробности см. в разделе о лимитах.

Интеграция с Python SDK

Используйте официальную библиотеку OpenAI для Python. Установите базовый URL и API-ключ при инициализации клиента. Идентификатор модели остается uncensored. Этот подход подходит для локальных скриптов или интеграций агентов, требующих программный доступ к API. Убедитесь, что версия вашей библиотеки поддерживает необходимые структуры API OpenAI.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Помните, что промпты не используются для обучения. Контекст вашего кода остается приватным для запроса.

Интеграция с Node SDK

Инициализируйте клиент OpenAI Node.js с пользовательским базовым URL. Передайте API-ключ из переменных окружения. Идентификатор модели uncensored необходим для всех завершений. Эта настройка идеальна для агентов на Node или серверных функций, требующих постоянной помощи AI.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Проверьте учетные данные перед массовыми запросами, чтобы избежать ненужных ошибок 402.

Потоковая передача ответов

Включите потоковую передачу, установив stream: true в теле запроса. API возвращает Server-Sent Events (SSE). Это позволяет вашему интерфейсу или агенту обрабатывать токены по мере их генерации. Потоковая передача снижает воспринимаемую задержку для больших ответов. Убедитесь, что ваш клиент корректно обрабатывает частичные фрагменты.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Каждый фрагмент содержит частичное содержимое. Агрегируйте их, чтобы сформировать окончательный ответ.

Лимиты, ошибки и контекст

Контекстное окно составляет 100 000 токенов для промпта и завершения запроса вместе. Лимит запросов — 300 запросов в минуту на ключ. Если вы сгенерируете новый ключ, старый будет немедленно отозван. Ошибка 401 указывает на недействительный ключ. Ошибка 402 указывает на недостаточный баланс. Ошибка 429 указывает на превышение лимита запросов. Баланс не сгорает. Варианты пополнения включают криптовалюту (USDT или USDC).