Руководство по быстрому старту для разработчиков

Предварительные требования: ваш API-ключ

Сгенерируйте свой ключ сразу после входа в систему. Перейдите на страницу получения API-ключа и авторизуйтесь через Google или пароль от электронной почты. Интерфейс мгновенно отобразит ваш уникальный ключ без необходимости указания номера телефона. Сохраните эту строку в безопасности, так как она аутентифицирует все запросы к базовому URL. Вам автоматически начисляется пробный кредит в размере $0.50, который истекает через семь дней, если его не использовать.

Настройка Cursor для совместимости с OpenAI

Направьте клиента на наш конкретный конечный пункт для обеспечения правильной маршрутизации. Установите базовый URL на HTTPS://api.keyapicursor.com/v1 и вставьте свой ключ в заголовок авторизации. Эта конфигурация работает с любым стандартным SDK, совместимым с OpenAI, без изменения имени модели. Вы должны указать идентификатор модели как uncensored, чтобы получить вывод с открытыми весами.

Отправка вашего первого запроса

Выполните простой запрос completion для проверки подключения и задержек. Используйте команду curl ниже для отправки базового промпта в конечную точку chat completions. Ответ возвращает объект JSON, содержащий сгенерированный текст. Проверьте поле usage, чтобы убедиться, что потребление токенов соответствует вашим ожиданиям.

Обработка потоковых ответов

Передавайте токены для меньшей воспринимаемой задержки в интерактивных приложениях. Сервер отправляет Server-Sent Events, содержащие частичные дельты, пока последний блок не включит общие данные об использовании. Разберите эти события для обновления пользовательского интерфейса в реальном времени. Этот метод работает идентично для клиентов Python и Node.

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

Повторно используйте существующие кодовые базы, изменив только параметры базового URL и ключа. Пример на Python демонстрирует прямую интеграцию с официальной библиотекой клиента. Пример Node следует тому же шаблону для сред JavaScript. Оба метода поддерживают режим JSON и вызов функций из коробки.

Понимание ограничений частоты запросов и токенов

Следите за объемом запросов, чтобы избежать сбоев в работе при интенсивном использовании. Система устанавливает лимит в 300 запросов в минуту на ключ. Вы можете выполнять восемь одновременных запросов одновременно с ограничением размера тела в 8 МБ. Ошибки, такие как 401 (недействительные ключи) или 402 (недостаточно средств), не потребляют ваш предоплаченный баланс.

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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

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)