API ключ cursor руководство по быстрому старту

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

Начните с генерации ключа на странице получения API-ключа. Нажмите «Продолжить с Google» или используйте электронную почту и пароль. Система сразу покажет ваш ключ. Храните его в безопасности.

Направьте клиент на HTTPS://api.apikeycursor.com/v1. Передайте ключ в заголовке Authorization как токен Bearer. Этот базовый URL работает с официальными SDK OpenAI и любым совместимым клиентом. Вам нужен только один активный ключ на аккаунт.

• Заголовок Auth: Авторизация: Bearer YOUR_KEY
• Базовый URL: HTTPS://api.apikeycursor.com/v1

Copycurl https://api.apikeycursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch current server load stats"}]
  }'

Эндпоинт chat completions

Вызовите POST /v1/chat/completions для генерации текста. Отправьте ваши сообщения в стандартном JSON формате. Идентификатор модели — uncensored. Она работает на наших серверах и не отказывается от законных тем для взрослых.

Вводные токены стоят $0.15 за 1M. Выходные токены стоят $0.50 за 1M. Ошибки и отказы бесплатны. Кредит не истекает. Вы можете пополнить счет через USDT (TRC20) или USDC (Base). Минимальная сумма — $20. При пополнении на $200 вы получаете бонус 15%.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikeycursor.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)

Потоковые ответы через SSE

Включите потоковую передачу, установив stream в true. Вы получаете события, отправляемые сервером. Каждый фрагмент содержит частичный текст. Последний фрагмент включает данные об использовании токенов.

Обработайте поток в коде. Обрабатывайте каждый чанк по мере его поступления. Это снижает воспринимаемую задержку для длинных ответов. Модель поддерживает контекстное окно на 100,000 токенов. Максимальный вывод — 16,000 токенов на запрос.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikeycursor.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);

Вызов функций и режим JSON

Используйте параметр tools для вызова функций. Определите ваши функции в схеме. Модель возвращает структурированные данные. Вы также можете принудительно вывести JSON, установив response_format в json_object.

Это работает для интеграций с ключом API Cursor. Проверьте JSON на своей стороне. Модель не гарантирует идеального синтаксиса. Используйте это для автоматизации. Разбирайте вызовы инструментов. Выполняйте их. Возвращайте результаты.

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)

Параметры: temperature и seed

Контролируйте креативность с помощью temperature. Более высокие значения делают выводы более случайными. Более низкие значения делают их детерминированными. Используйте seed для воспроизводимых результатов. Это помогает отлаживать настройку промптов.

Другие параметры включают top_p, stop и presence_penalty. Настраивайте их в зависимости от вашей задачи. Настройте стиль ответа. uncensored модель хорошо реагирует на прямые запросы. Она не отказывает от спорных тем.

Проверьте страницу с ценами на стоимость токенов. Используйте пробный кредит для тестирования.

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

Вы получаете 300 запросов в минуту. Вы можете выполнять 8 запросов одновременно. Лимит тела запроса — 8 МБ. Контекстное окно составляет 100 000 токенов в сумме. Промпт и завершение делят это пространство.

Ошибки возвращают стандартные HTTP-коды. 401 означает недействительный ключ. 402 означает отсутствие средств. 429 означает превышение лимита частоты запросов. Проверьте страницу поддержки для возврата средств. Ошибки вроде двойного списания исправляются там. Кредит не возвращается в других случаях.