Посібник швидкого старту для розробників

Передумови: ваш API-ключ

Згенеруйте свій ключ одразу після входу. Відвідайте сторінку отримання API-ключа та автентифікуйтеся через Google або пароль від електронної пошти. Інтерфейс миттєво відобразить ваш унікальний ключ без необхідності вказувати номер телефону. Зберігайте цей рядок у безпеці, оскільки він автентифікує всі запити до базового URL. Ви автоматично отримуєте $0.50 пробного кредиту, який згорає через сім днів, якщо ним не скористатися.

Налаштування Cursor для сумісності з OpenAI

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

Надсилання вашого першого запиту

Виконайте просте завершення для перевірки з’єднання та затримки. Використовуйте наведену нижче команду curl для надсилання базового промпту до кінцевої точки chat completions. У відповіді повертається об’єкт JSON із згенерованим текстом. Перевірте поле usage, щоб підтвердити, що споживання токенів відповідає вашим очікуванням.

Обробка потокових відповідей

Потокова передача токенів для зменшення сприйваної затримки в інтерактивних додатках. Сервер надсилає події, що надсилаються сервером (SSE), що містять часткові дельти, доки кінцевий пакет не міститиме загальні дані про використання. Парсуйте ці події, щоб оновлювати інтерфейс користувача в реальному часі. Цей метод працює однаково на клієнтах Python та Node.

Інтеграція з SDK Python та Node

Перевиживайте існуючі кодові бази, змінивши лише параметри базового 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)